huggingface/smolagents

Что это?

Ключевые возможности

• 01CodeAgent записывает действия на Python, а вызовы инструментов оформляет как вызовы функций.
• 02Поддерживает локальные модели transformers и Ollama, провайдеров Hugging Face, совместимые с OpenAI API и LiteLLM.
• 03Запускает сгенерированный код в изолированных средах, например E2B, Modal, Blaxel или Docker.
• 04Импортирует инструменты с MCP-серверов, из LangChain и Hugging Face Spaces.
• 05Позволяет публиковать агентов и инструменты на Hugging Face Hub.
• 06Включает интерфейсы командной строки smolagent и webagent.

Сценарии использования

• Создание прототипа агента, который за один запуск вызывает несколько веб-инструментов или API.
• Разработка исследовательского помощника или помощника для веб-сёрфинга, которому нужны многошаговые рассуждения.
• Эксперименты с моделями с открытым исходным кодом для агентных рабочих процессов.
• Изучение того, чем агенты на основе кода отличаются от агентов с вызовами инструментов в формате JSON.

Быстрый старт

1. 1

   Установите пакет с набором инструментов по умолчанию

   pip install "smolagents[toolkit]"
2. 2

   Определите CodeAgent с инструментами и моделью, а затем запустите его

Что важно знать

• !Для безопасного выполнения кода агента нужна внешняя песочница, например E2B, Blaxel, Modal или Docker; встроенный LocalPythonExecutor не является границей безопасности.
• !Демонстрационная модель по умолчанию размещена на Hugging Face, поэтому обычно требуется учетная запись провайдера или API-ключ.

Темы

Частые вопросы

Что такое smolagents?

Минималистичная библиотека Python для создания AI-агентов, которые записывают свои действия на Python и выполняют их. smolagents — компактная библиотека Python для создания агентов на базе LLM. Её основной агент CodeAgent записывает каждое действие в виде фрагмента кода Python, поэтому вызовы инструментов выглядят как обычные вызовы функций, а агент может за один шаг объединить несколько инструментов. Логика агентов намеренно сделана компактной: основной модуль с агентами содержит менее 1 000 строк, так что разработчики могут изучать и напрямую изменять исходный код.

smolagents можно использовать бесплатно? Какая у него лицензия?

smolagents распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

smolagents всё ещё поддерживается?

Активно поддерживается. Последний коммит в smolagents — 6 окт. 2026 г..

Для чего можно использовать smolagents?

Создание прототипа агента, который за один запуск вызывает несколько веб-инструментов или API. Разработка исследовательского помощника или помощника для веб-сёрфинга, которому нужны многошаговые рассуждения. Эксперименты с моделями с открытым исходным кодом для агентных рабочих процессов. Изучение того, чем агенты на основе кода отличаются от агентов с вызовами инструментов в формате JSON.

Как установить smolagents?

Установите пакет с набором инструментов по умолчанию: pip install "smolagents[toolkit]" Определите CodeAgent с инструментами и моделью, а затем запустите его

Где скачать smolagents?

Исходный код и инструкции по установке — на GitHub: https://github.com/huggingface/smolagents