¿Qué es smolagents?
smolagents es una pequeña biblioteca de agentes de Hugging Face. Su clase principal, CodeAgent, escribe cada acción como un breve fragmento de Python que llama a herramientas, hace bucles o calcula valores, en lugar de emitir una llamada a herramienta en JSON cada vez. Hay un ToolCallingAgent disponible para el estilo JSON clásico.
Como el agente ejecuta código que ha escrito él mismo, el README indica que se use un sandbox: E2B, Blaxel, Modal o Docker. El LocalPythonExecutor integrado no es, en palabras del README, una frontera de seguridad.
Funciona con modelos locales de transformers u Ollama, proveedores de inferencia de Hugging Face y API comerciales a través de LiteLLM, y puede cargar herramientas de servidores MCP, LangChain y Spaces del Hub. La última versión, la v1.26.0, salió el 29 de mayo de 2026; los commits desde agosto han sido de mantenimiento de CI y seguridad.
¿Merece la pena smolagents?
smolagents funciona mejor como lección que como dependencia. Su última versión, la v1.26.0, llegó el 29 de mayo de 2026, tras un ritmo de unas dos al mes hasta principios de 2026. Los commits continuaron, pero los posteriores a agosto fijan versiones de GitHub Actions, acotan tokens y actualizan el generador de la documentación; ninguno añade funciones. Frente a unas 30.000 estrellas hay 405 issues abiertos y 590 pull requests abiertas.
La idea sigue siendo sólida y está bien argumentada. Escribir una acción como código permite a un agente encadenar varias llamadas a herramientas, bucles y condicionales en un solo paso; el README cita investigaciones que muestran un 30 % menos de pasos, y por tanto menos llamadas al modelo, que las llamadas a herramientas en JSON. La lógica central del agente ocupa menos de 1.000 líneas, lo bastante corta para leerla en una tarde.
La pega es el modelo de seguridad. Ejecutar con seguridad Python escrito por un modelo necesita un sandbox de verdad, y el ejecutor local ya ha sido vulnerado: CVE-2025-5120 y CVE-2025-9959 fueron fugas del sandbox en LocalPythonExecutor, y el README dice ahora sin rodeos que no es una frontera de seguridad. E2B, Blaxel, Modal o Docker añaden un segundo servicio que mantener y pagar.
Para agentes de producción duraderos, Pydantic AI y LangGraph ofrecen salidas tipadas, persistencia y trazas que smolagents deja en tus manos, con un ritmo de versiones más estable. La integración con el Hugging Face Hub, incluida la posibilidad de subir un agente entero a un Space, sigue siendo algo que ninguno de los dos rivales iguala.
Dónde se gana su sitio
Una investigadora de ML que compara modelos abiertos en tareas de agentes
Medir lo bien que un modelo del Hub planifica y llama a herramientas
Cambiar de modelo a través del Hub u Ollama con el mismo CodeAgent y el script de benchmark del repositorio; la biblioteca es gratuita y el coste es la inferencia.
Un responsable de ingeniería que enseña a un equipo cómo funcionan los agentes
Mostrar el bucle del agente de principio a fin sin abstracciones de framework
El agents.py de menos de 1.000 líneas se puede leer en una sesión; combínalo con un sandbox Docker para que los ejercicios nunca ejecuten código generado en los portátiles.
Un CTO que valora un framework de agentes para un producto a dos años
Decidir si estandarizar en smolagents
Cinco meses sin versiones y 590 pull requests abiertas son un riesgo de mantenimiento; presupuestar un fork o una migración posterior, o elegir un framework con versiones más regulares, es la opción prudente.
Antes de decidirte
- Puesta en marcha
- pip install "smolagents[toolkit]" en Python 3.10 o posterior; un primer CodeAgent con un modelo del Hub o de API funciona en unas pocas líneas. Añade un sandbox de E2B, Modal, Blaxel o Docker antes de procesar entradas no fiables.
- Integraciones
- Modelos a través de transformers, Ollama, proveedores de inferencia de Hugging Face y LiteLLM; herramientas de servidores MCP, LangChain y Spaces del Hub; los agentes se pueden subir al Hub y descargar de él.
- Datos y privacidad
- Apache 2.0. No se envía nada a ninguna parte más allá de los proveedores de modelos y sandbox que configures. CVE-2025-5120 y CVE-2025-9959 fueron fugas del sandbox en LocalPythonExecutor, que según el README no debe usarse como frontera de seguridad.
- Coste a escala
- La biblioteca es gratuita; la factura son los tokens del modelo más el tiempo de sandbox en E2B, Modal o Blaxel, o tus propios hosts Docker.
- Límites
- 405 issues abiertos y 590 pull requests abiertas; sin versiones desde el 29 de mayo de 2026. Sin persistencia ni ejecución duradera integradas.
Lo bueno
- El diseño de código como acción reduce las llamadas al modelo
- Lógica central de menos de 1.000 líneas
- Cualquier modelo a través de transformers, Ollama, proveedores del Hub o LiteLLM
- Herramientas de MCP, LangChain y Spaces del Hub
Lo malo
- Sin versiones desde mayo de 2026; los commits recientes son de mantenimiento
- El ejecutor local ha tenido CVE de fuga del sandbox
- Pocas funciones de producción: persistencia, salidas tipadas, trazas
- 590 pull requests abiertas
Ideal para
Investigadores y estudiantes que exploran agentes que escriben código, sobre todo con modelos abiertos.
Alternativas a smolagents
smolagents: preguntas frecuentes
- ¿Merece la pena smolagents?
- Una demostración clara de que los agentes pueden actuar con código, que ahora va derivando hacia el modo mantenimiento con 590 pull requests esperando. Le damos un 3.5 sobre 5.
- ¿Cuánto cuesta smolagents?
- Gratuita y de código abierto con licencia Apache 2.0.
- ¿Qué inconvenientes tiene smolagents?
- Sin versiones desde mayo de 2026; los commits recientes son de mantenimiento; el ejecutor local ha tenido CVE de fuga del sandbox; pocas funciones de producción: persistencia, salidas tipadas, trazas; 590 pull requests abiertas.
- ¿Para quién es smolagents?
- Investigadores y estudiantes que exploran agentes que escriben código, sobre todo con modelos abiertos.
- ¿Cuánto cuesta smolagents para un equipo o en producción?
- La biblioteca es gratuita; la factura son los tokens del modelo más el tiempo de sandbox en E2B, Modal o Blaxel, o tus propios hosts Docker.
- ¿Es smolagents seguro para los datos de la empresa?
- Apache 2.0. No se envía nada a ninguna parte más allá de los proveedores de modelos y sandbox que configures. CVE-2025-5120 y CVE-2025-9959 fueron fugas del sandbox en LocalPythonExecutor, que según el README no debe usarse como frontera de seguridad.
- ¿Cuáles son las mejores alternativas a smolagents?
- Las alternativas más cercanas que hemos analizado son Pydantic AI, OpenAI Agents SDK y LangGraph.
Respuestas comprobadas el 26 oct 2026.