LibreAI / Agentes de IA / smolagents
// agents · huggingface/smolagents

smolagents

smolagents é um projeto de agentes de IA de código aberto de huggingface (huggingface/smolagents no GitHub). Tem 29.927 estrelas no GitHub e 3.106 forks, é publicado sob a licença Apache-2.0 e foi atualizado pela última vez no GitHub em 6 de outubro de 2026.

smolagents — Hugging Face's barebones agent library where agents think in code: a CodeAgent that writes its actions as Python, model-agnostic, Apache-2.0

★ 29,9 mil estrelas⑂ 3,1 mil forksApache-2.0atualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Estrelas no GitHub
29.927
Forks
3.106
Licença
Apache-2.0
Última atualização no GitHub
6 de outubro de 2026
Categoria
Agentes de IA
Tipo de ficha
Guia de instalação completo
Site oficial
Documentation
// como funciona

Como funciona

  1. Install the package

    Per the README: pip install "smolagents[toolkit]" for the package with the default tool set.

  2. Pick a model

    Create a model object — InferenceClientModel for Hub inference providers, or a local transformers/Ollama model, or another provider model.

  3. Define and run an agent

    Give a CodeAgent your tools (e.g. WebSearchTool) and the model, then call agent.run() with a task in plain language.

// recursos

Por que as pessoas gostam tanto

Agents that act in code

CodeAgent writes executable Python actions instead of JSON blobs — plans, loops and tool chaining come naturally and traces stay readable.

Model-agnostic

HF Inference Providers, local transformers/Ollama models and major hosted providers all plug into the same agent code.

Barebones by design

A small, hackable codebase you can actually read end to end — the anti-framework agent library.

Hub-native tools

Tools are Python functions you can share on and pull from the Hugging Face Hub, alongside the bundled toolkit.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Install

    The README quick install with the default toolkit.

    pip install "smolagents[toolkit]"
  2. First agent

    The README example: a CodeAgent with web search on a Hub model.

    from smolagents import CodeAgent, WebSearchTool, InferenceClientModel
    
    model = InferenceClientModel()
    agent = CodeAgent(tools=[WebSearchTool()], model=model)
    agent.run("How many seconds would it take for a leopard at full speed to run through Pont des Arts?")
  3. Go local

    Swap InferenceClientModel for a local transformers or Ollama model class from the docs — the agent code does not change.

    https://huggingface.co/docs/smolagents
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who makes smolagents?

The Hugging Face team (huggingface/smolagents on GitHub).

Is smolagents free?

Yes — Apache-2.0 licensed. Model usage follows whatever provider or local model you plug in.

Why code actions instead of tool calls?

Code is more expressive than one-tool-per-step JSON: the agent can loop, branch, store intermediate results and compose tools in a single action, and the trace reads like a program you can debug. Execution is sandboxed per the library docs — still review what you let it run.

How does it compare to a well-known alternative?

Against LangChain/LangGraph, smolagents is intentionally minimal — far less surface area, no graph DSL, quicker to learn and hack. Against AutoGen or CrewAI, it is a library for building your agent, not a multi-agent role-play system.

How do I get started?

pip install "smolagents[toolkit]", then run the README CodeAgent example with InferenceClientModel and WebSearchTool.

// continue explorando

Ferramentas semelhantes

Agentes de IA

tons-of-skills-marketplace

Model-agnostic marketplace of agent skills with a harness-free canonical layer.

★ 2,8 mil estrelasMIT
Ver o guia →
Agentes de IA

hermes-agent

The agent that grows with you — a Python framework for adaptive AI agents.

★ 252,0 mil estrelasMIT
Ver o guia →
Agentes de IA

openclaude

A Claude Code-style coding agent that runs anywhere and works with almost any model provider

★ 33,7 mil estrelasMIT
Ver o guia →
Agentes de IA

E2B

Secure sandboxes where AI agents run real code.

★ 14,2 mil estrelasApache-2.0
Ver o guia →
Agentes de IA

OmAgent

Python library for building multimodal language agents — VLM, video and mobile, fast to prototype and ship

★ 2,7 mil estrelasApache-2.0
Ver o guia →
Agentes de IA

CoreCoder

Self-hosted ai agents: minimal ai coding agent (~1,000 lines of python) inspir.

★ 1,8 mil estrelasMIT
Ver o guia →
// alternativas

Alternativas em Agentes de IA

Os outros projetos de Agentes de IA com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se smolagents não for o ideal para você.

// mais em agents

Mais em Agentes de IA

Projetos de Agentes de IA próximos no catálogo, os mais próximos em estrelas de smolagents: continue explorando dos dois lados dele.

Baixe o smolagents

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.