smolagents: opinión, precio, seguridad y alternativas

Qué hace smolagents

smolagents pertenece a la familia de frameworks: bibliotecas para desarrollar sus propios agentes en código: bucle, herramientas, memoria, orquestación. En nuestra tabla ocupa el puesto 10 de los 28 proyectos de esta familia del directorio.

Un framework no se usa tal cual: es una biblioteca que los desarrolladores integran en su propio código para describir las herramientas del agente, su bucle de decisión y su memoria. Exige conocimientos de programación, pero deja el control de cada detalle.

Se usa desde: SDK para desarrolladores. Modelos utilizables: cualquier modelo compatible con la API de OpenAI y modelos locales (Ollama, llama.cpp, vLLM…). Puede funcionar en su propia máquina o servidor.

Presentación del repositorio (en inglés): «🤗 smolagents: a barebones library for agents that think in code.»

¿Para quién es smolagents?

Se dirige a desarrolladores que construyen su propio agente o integran IA agéntica en un producto. Ejemplos de tareas que se le confían:

• crear un agente de negocio conectado a sus API
• orquestar llamadas a herramientas y modelos
• añadir memoria y recuperación de errores a un agente

Es un buen candidato si sus datos deben quedarse en sus máquinas y quiere poder usar un modelo local, sin coste de API.

Accesos y control humano

Un framework no tiene accesos propios: las herramientas que le conecte definen lo que el agente puede hacer. Empiece con herramientas de solo lectura.

No hemos podido establecer si pide validación humana antes de las acciones sensibles: pruébelo primero en una cuenta o carpeta sin importancia.

Precio de smolagents

El código es gratuito, con licencia Apache-2.0.

Empezar con smolagents

1. Instálelo: el proyecto se distribuye como un paquete de Python (instalación con pip o uv). El comando exacto figura en el README del repositorio.
2. Elija el modelo: una clave de API de un proveedor, o un modelo local si su máquina tiene suficiente memoria gráfica (la calculadora de VRAM se lo indica).
3. Empiece por el ejemplo mínimo de la documentación y añada una sola herramienta cada vez comprobando lo que hace el agente con ella.
4. Encárguele una tarea corta y verificable, revise el resultado y el registro de sus acciones, y luego aumente la dificultad poco a poco.

Seguridad: nivel de riesgo

Un framework no protege por defecto: la validación humana, los permisos mínimos y el aislamiento dependen de usted.

Tres reflejos: mínimo privilegio (permisos mínimos, claves dedicadas), validación humana para las acciones irreversibles, sandbox para la ejecución de código. El diagnóstico de seguridad de agentes IA revisa su instalación en pocos minutos.

Actividad del proyecto y versiones

Creado el 5 de diciembre de 2024, el repositorio huggingface/smolagents suma 30.029 estrellas, 3139 copias (forks) y 408 incidencias abiertas, con 1059 commits en total. Ha recibido cambios este mes.

En las últimas 52 semanas: 82 commits, una media de 1,6 por semana.

36 versiones publicadas en total; 4 en los últimos doce meses. Última versión: v1.26.0, el 29 de mayo de 2026.

smolagents frente a otros frameworks

Estrellas de GitHub de los proyectos de código abierto mejor valorados de la familia frameworks. Las estrellas miden la atención, no la calidad: un proyecto muy mediático las acumula rápido, una herramienta especializada tendrá pocas.

smolagents y otros frameworks en una tabla

Los 7 agentes mejor clasificados de la misma familia, 7 de ellos de código abierto. La nota sobre 100 solo se aplica a los proyectos de código abierto; para los servicios propietarios indicamos el precio de entrada publicado. Un guion señala un dato que la documentación no precisa.

Cómo lo hemos evaluado

Nota: 78/100, calculada solo con datos públicos y verificables, sin pruebas subjetivas ni acuerdos comerciales:

• Adopción 30/40: 30.029 estrellas en escala logarítmica (40 puntos a partir de unas 200 000).
• Actividad 23/30: último commit hace menos de un mes, 2 versiones en seis meses, 82 commits en un año.
• Marco 25/30: licencia, validación humana por defecto, autoalojamiento, elección de modelo y sitio de documentación.

La nota no dice si el agente resolverá sus tareas: mide la solidez del proyecto. La tabla completa está en la página de método.