Repolode
huggingface

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. 1

    Instala el paquete con el kit de herramientas predeterminado

    pip install "smolagents[toolkit]"
  2. 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