O que é smolagents?
O smolagents é uma pequena biblioteca de agentes da Hugging Face. Sua classe principal, CodeAgent, escreve cada ação como um trecho curto de Python que chama ferramentas, faz loops ou calcula valores, em vez de emitir uma chamada de ferramenta em JSON por vez. Um ToolCallingAgent está disponível para o estilo JSON clássico.
Como o agente executa código que ele mesmo escreveu, o README recomenda usar um sandbox: E2B, Blaxel, Modal ou Docker. O LocalPythonExecutor integrado, nas palavras do README, não é uma fronteira de segurança.
Funciona com modelos locais via transformers ou Ollama, com provedores de inferência da Hugging Face e com APIs comerciais via LiteLLM, e pode carregar ferramentas de servidores MCP, LangChain e Hub Spaces. A última release, v1.26.0, foi em 29 de maio de 2026; os commits desde agosto têm sido manutenção de CI e de segurança.
smolagents vale a pena?
O smolagents funciona melhor como lição do que como dependência. Sua última release, a v1.26.0, saiu em 29 de maio de 2026, depois de cerca de duas por mês até o início de 2026. Os commits continuaram, mas os de agosto para cá fixam versões de GitHub Actions, restringem tokens e atualizam o gerador da documentação; nenhum acrescenta funcionalidades. Contra cerca de 30.000 estrelas, há 405 issues abertas e 590 pull requests abertos.
A ideia continua sólida e bem argumentada. Escrever uma ação como código permite a um agente encadear várias chamadas de ferramenta, loops e condicionais em uma única etapa; o README cita pesquisas que mostram 30% menos etapas, e portanto menos chamadas de modelo, do que a chamada de ferramentas em JSON. A lógica central do agente tem menos de 1.000 linhas, curta o bastante para ler em uma tarde.
O porém é o modelo de segurança. Executar com segurança Python escrito por modelo exige um sandbox de verdade, e o executor local já foi quebrado: CVE-2025-5120 e CVE-2025-9959 foram fugas do sandbox no LocalPythonExecutor, e o README agora diz claramente que ele não é uma fronteira de segurança. E2B, Blaxel, Modal ou Docker acrescentam um segundo serviço para operar e pagar.
Para agentes de produção duráveis, o Pydantic AI e o LangGraph oferecem saídas tipadas, persistência e tracing que o smolagents deixa por sua conta, com ciclos de release mais estáveis. A integração com o Hugging Face Hub, incluindo publicar um agente inteiro em um Space, continua sendo algo que nenhum dos dois rivais iguala.
Onde ele se destaca
Um pesquisador de ML comparando modelos abertos em tarefas de agente
Medir quão bem um modelo do Hub planeja e chama ferramentas
Troque os modelos pelo Hub ou pelo Ollama com o mesmo CodeAgent e o script de benchmark do repositório; a biblioteca é gratuita e o custo é a inferência.
Um líder de engenharia ensinando a equipe como agentes funcionam
Mostrar o loop do agente de ponta a ponta sem abstrações de framework
O agents.py, com menos de 1.000 linhas, dá para ler em uma sessão; combine-o com um sandbox Docker para que os exercícios nunca executem código gerado nos laptops.
Um CTO avaliando um framework de agentes para um produto de dois anos
Decidir se vale padronizar no smolagents
Cinco meses sem release e 590 pull requests abertos são um risco de manutenção; reservar orçamento para fazer um fork ou migrar depois, ou escolher um framework com releases mais estáveis, é a opção cautelosa.
Antes de decidir
- Configuração
- pip install "smolagents[toolkit]" em Python 3.10 ou mais recente; um primeiro CodeAgent com um modelo do Hub ou de API roda em poucas linhas. Adicione um sandbox E2B, Modal, Blaxel ou Docker antes de processar entrada não confiável.
- Integrações
- Modelos via transformers, Ollama, provedores de inferência da Hugging Face e LiteLLM; ferramentas de servidores MCP, LangChain e Hub Spaces; agentes podem ser enviados ao Hub e baixados dele.
- Dados e privacidade
- Apache 2.0. Nada é enviado a lugar nenhum além dos provedores de modelo e de sandbox que você configurar. CVE-2025-5120 e CVE-2025-9959 foram fugas do sandbox no LocalPythonExecutor, que o README diz que não deve ser usado como fronteira de segurança.
- Custo em escala
- A biblioteca é gratuita; a conta são tokens de modelo mais tempo de sandbox no E2B, Modal ou Blaxel, ou seus próprios hosts Docker.
- Limites
- 405 issues abertas e 590 pull requests abertos; nenhuma release desde 29 de maio de 2026. Sem persistência integrada nem execução durável.
O que é bom
- O design de código como ação reduz as chamadas de modelo
- Lógica central com menos de 1.000 linhas
- Qualquer modelo via transformers, Ollama, provedores do Hub ou LiteLLM
- Ferramentas de MCP, LangChain e Hub Spaces
O que não é
- Nenhuma release desde maio de 2026; os commits recentes s ão manutenção
- O executor local já teve CVEs de fuga do sandbox
- Poucos recursos de produção: persistência, saídas tipadas, tracing
- 590 pull requests abertos
Ideal para
Pesquisadores e estudantes explorando agentes que escrevem código, especialmente com modelos abertos.
Alternativas ao smolagents
smolagents: perguntas frequentes
- smolagents vale a pena?
- Uma demonstração clara de que agentes podem agir em código, agora deslizando para o modo de manutenção com 590 pull requests à espera. Damos nota 3.5 de 5.
- Quanto custa smolagents?
- Gratuito e de código aberto sob a licença Apache 2.0.
- Quais são as desvantagens de smolagents?
- Nenhuma release desde maio de 2026; os commits recentes são manutenção; o executor local já teve CVEs de fuga do sandbox; poucos recursos de produção: persistência, saídas tipadas, tracing; 590 pull requests abertos.
- Para quem smolagents é indicado?
- Pesquisadores e estudantes explorando agentes que escrevem código, especialmente com modelos abertos.
- Quanto custa smolagents para uma equipe ou em produção?
- A biblioteca é gratuita; a conta são tokens de modelo mais tempo de sandbox no E2B, Modal ou Blaxel, ou seus próprios hosts Docker.
- smolagents é seguro para dados da empresa?
- Apache 2.0. Nada é enviado a lugar nenhum além dos provedores de modelo e de sandbox que você configurar. CVE-2025-5120 e CVE-2025-9959 foram fugas do sandbox no LocalPythonExecutor, que o README diz que não deve ser usado como fronteira de segurança.
- Quais são as melhores alternativas ao smolagents?
- As alternativas mais próximas que analisamos são Pydantic AI, OpenAI Agents SDK e LangGraph.
Respostas verificadas em 26 de out. de 2026.