Framework de Python para crear agentes de IA autónomos que investigan, planifican, programan y ejecutan tareas, con memoria, RAG y más de 100 proveedores de LLM.
huggingface/smolagents
Una biblioteca mínima de Python para crear agentes de IA que escriben y ejecutan sus acciones como código Python.
- Estrellas
- 29,943
- Forks
- 3,111
- Issues abiertos
- 974
- Último commit
- hace 14 días
¿Qué es?
smolagents es una pequeña biblioteca de Python para crear agentes basados en LLM. Su componente principal, CodeAgent, escribe cada acción como un fragmento de código Python, de modo que las llamadas a herramientas se convierten en llamadas a funciones normales y el agente puede encadenar varias herramientas en un solo paso. La lógica del agente se mantiene deliberadamente compacta: el módulo principal de agentes tiene menos de 1.000 líneas, así que los desarrolladores pueden leer y modificar el código fuente directamente.
La biblioteca no depende de un modelo concreto. Puede ejecutar modelos locales de transformers u Ollama, modelos disponibles a través de los proveedores de inferencia de Hugging Face, endpoints compatibles con OpenAI y cientos de modelos mediante LiteLLM, incluidos Azure OpenAI y Amazon Bedrock. Las herramientas pueden provenir de servidores MCP, LangChain, Hugging Face Spaces o el Hub; además, se pueden publicar agentes y herramientas en el Hub y cargarlos desde allí.
Como el código generado por los agentes puede ser peligroso, el proyecto recomienda ejecutarlo en un sandbox como E2B, Modal, Blaxel o Docker. El ejecutor local de Python incluido no es, explícitamente, una barrera de seguridad. También está disponible ToolCallingAgent, que usa llamadas a herramientas al estilo JSON, y el paquete incluye las herramientas de línea de comandos `smolagent` y `webagent`.
Funciones clave
- 01CodeAgent escribe las acciones como código Python y convierte las llamadas a herramientas en llamadas a funciones.
- 02Admite modelos locales de transformers y Ollama, proveedores de Hugging Face, API compatibles con OpenAI y LiteLLM.
- 03Ejecuta el código generado en sandboxes como E2B, Modal, Blaxel o Docker.
- 04Importa herramientas de servidores MCP, LangChain y Hugging Face Spaces.
- 05Comparte agentes y herramientas a través de Hugging Face Hub.
- 06Incluye las interfaces de línea de comandos smolagent y webagent.
Casos de uso
- Crear un prototipo de agente que use varias herramientas web o API en una misma ejecución.
- Crear un asistente de investigación o navegación que necesite razonamiento en varios pasos.
- Experimentar con modelos de código abierto para flujos de trabajo con agentes.
- Enseñar o estudiar en qué se diferencian los agentes basados en código de los agentes que llaman a herramientas mediante JSON.
Inicio rápido
- 1
Instala el paquete con el kit de herramientas predeterminado
pip install "smolagents[toolkit]" - 2
Define un CodeAgent con herramientas y un modelo, y luego ejecútalo
Antes de usarlo
- Para ejecutar código de agentes de forma segura, se necesita un entorno aislado externo, como E2B, Blaxel, Modal o Docker; el LocalPythonExecutor integrado no constituye una barrera de seguridad.
- El modelo de demostración predeterminado está alojado en Hugging Face, por lo que normalmente se necesita una cuenta del proveedor o una clave de API.
Temas
Preguntas frecuentes
- ¿Qué es smolagents?
- Una biblioteca mínima de Python para crear agentes de IA que escriben y ejecutan sus acciones como código Python. smolagents es una pequeña biblioteca de Python para crear agentes basados en LLM. Su componente principal, CodeAgent, escribe cada acción como un fragmento de código Python, de modo que las llamadas a herramientas se convierten en llamadas a funciones normales y el agente puede encadenar varias herramientas en un solo paso. La lógica del agente se mantiene deliberadamente compacta: el módulo principal de agentes tiene menos de 1.000 líneas, así que los desarrolladores pueden leer y modificar el código fuente directamente.
- ¿smolagents es gratuito? ¿Qué licencia tiene?
- smolagents es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿smolagents sigue mantenido?
- Mantenimiento activo. El último commit de smolagents fue el 6 oct 2026.
- ¿Para qué puedo usar smolagents?
- Crear un prototipo de agente que use varias herramientas web o API en una misma ejecución. Crear un asistente de investigación o navegación que necesite razonamiento en varios pasos. Experimentar con modelos de código abierto para flujos de trabajo con agentes. Enseñar o estudiar en qué se diferencian los agentes basados en código de los agentes que llaman a herramientas mediante JSON.
- ¿Cómo se instala smolagents?
- Instala el paquete con el kit de herramientas predeterminado: pip install "smolagents[toolkit]" Define un CodeAgent con herramientas y un modelo, y luego ejecútalo
- ¿Dónde consigo smolagents?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/huggingface/smolagents
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Framework de Python de código abierto para orquestar agentes de IA autónomos basados en roles (Crews) y flujos de trabajo basados en eventos (Flows).
Un harness de agentes para Python, con opiniones claras y todo incluido, que ejecuta tareas largas de varios pasos desde el primer momento sobre LangGraph.
Framework ligero de Python para crear flujos de trabajo multiagente con herramientas, transferencias, guardrails, sesiones y trazas, compatible con OpenAI y más de 100 LLMs.
SDK para crear agentes de IA y sistemas multiagente en Python, .NET y Java, con integraciones de modelos, plugins y bases de datos vectoriales.
SDK de código abierto para crear y ejecutar agentes de IA en Python y TypeScript, con herramientas, MCP, memoria y compatibilidad con distintos modelos.