LibreAI / AI Agents / smolagents
// agents · huggingface/smolagents

smolagents

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.9k stars⑂ 3.1k forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

smolagents is an open-source ai agents project by huggingface (huggingface/smolagents on GitHub). It has 29,927 GitHub stars and 3,106 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 6 October 2026.

GitHub stars
29,927
Forks
3,106
License
Apache-2.0
Last updated on GitHub
6 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Documentation
// how it works

How it works

  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.

// features

Why people love it

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
// run it

Run it yourself

  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
// use cases

What you can build

Advertisement
// faq

Questions, answered

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.

// keep exploring

Similar tools

Agents

tons-of-skills-marketplace

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

★ 2.8k starsMIT
View guide →
AI Agents

hermes-agent

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

★ 252.0k starsMIT
View guide →
AI Agents

openclaude

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

★ 33.7k starsMIT
View guide →
AI Agents

E2B

Secure sandboxes where AI agents run real code.

★ 14.2k starsApache-2.0
View guide →
AI Agents

OmAgent

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

★ 2.7k starsApache-2.0
View guide →
AI Agents

CoreCoder

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

★ 1.8k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if smolagents is not the right fit.

Get smolagents

Free and open — grab the source, star the repo, and start creating.