smolagents

smolagents — минималистичный фреймворк от Hugging Face: агенты, которые действуют, генерируя и запуская код (code agents).

HFHugging Face Фреймворк агентов Python ★ 30.4k

Что это

smolagents — минималистичный фреймворк от Hugging Face: агенты, которые действуют, генерируя и запуская код (code agents).

Установка

1Установить пакет
pip install "smolagents[toolkit]"
2Быстрый старт
from smolagents import CodeAgent, WebSearchTool, InferenceClientModel model = InferenceClientModel() agent = CodeAgent(tools=[WebSearchTool()], model=model, stream_outputs=True) agent.run("How many seconds would it take for a leopard at full speed to run through Pont des Arts?")

Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.

Что нового в версиях

v1.26.029 мая 2026 г.

Обновление версии, исправление ошибок форматирования строк, улучшение документации и добавление поддержки поисковой системы Exa.

  • Добавлена поддержка поисковой системы Exa в WebSearchTool.
  • Исправлено экранирование f-string в сообщении об ошибке ToolSerializer.dumps.
  • Удален удаленный WasmExecutor.
  • Обновлен docstring для LocalPythonExecutor.
  • Исправлены опечатки в документации, примерах и тестах.
  • Добавлено новое сообщение об ошибке для тестов провайдеров LiteLLM без ключа.
v1.25.014 мая 2026 г.

Исправление уязвимостей безопасности, обновление документации и поддержка huggingface-hub >= 1

  • Исправлена высокоуровневая уязвимость безопасности в удаленных исполнителях
  • Добавлена документация по интеграции с MLflow и странице справки для Python-исполнителей
  • Добавлена поддержка huggingface-hub >= 1
  • Исправлена ошибка вызова __exit__ в evaluate_with и рендеринга Rich MarkupError в AgentLogger.log_task
  • Имплементирована передача токена в DockerExecutor и WasmExecutor, а также изоляция кэша Deno
v1.24.016 января 2026 г.

Обновление версии 1.24.0 с улучшением безопасности выполнения кода, поддержкой Gradio 6 и исправлением ошибок.

  • Добавлен надежный механизм тайм-аута для выполнения кода на Python.
  • Обеспечена совместимость с Gradio 6.
  • Добавлена поддержка модели gpt-5.2* в списке моделей без стоп-последовательностей.
  • Исправлена ошибка подсчета токенов в run_gaia.py при повторном вызове управляемого агента.
  • Исправлено перехватывание FinalAnswerException блоком except Exception.
  • Добавлена обратная совместимость для устаревшего HfApiModel.
v1.23.017 ноября 2025 г.

Обновление модели по умолчанию, поддержка gpt-5.1, диалоговый режим CLI и улучшение локального Python-исполнителя

  • Изменена модель по умолчанию в InferenceClient на Qwen/Qwen3-Next-80B-A3B-Thinking
  • Добавлена поддержка модели gpt-5.1
  • Добавлен диалоговый режим CLI (Dialog mode CLI)
  • Оптимизирована оценка выполнения в LocalPythonExecutor и добавлена поддержка вложенных dictcomp/setcomp
  • Исправлена ошибка с потерей контекста OpenTelemetry при параллельных вызовах инструментов
v1.22.025 сентября 2025 г.

Обновление smolagents v1.22.0: поддержка новых моделей и экосистемы, улучшение исполнителей и исправление ошибок.

  • Добавлена поддержка модели GPT-5 и исправлена ошибка с параметром stop для Grok-4/Grok-3-mini.
  • Добавлен Modal Remote Executor и улучшена поддержка пользовательских Dockerfile в DockerExecutor.
  • Добавлена поддержка e2b-code-interpreter v2 и MCP structured output.
  • Исправлена ошибка с параметром stop для GPT-5 и улучшена сериализация RunResult.
  • Исправлены предупреждения о deprecated параметрах (messages, max_new_tokens) и ошибка XPath injection.

Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.