smolagents: review, pricing, security and alternatives

What smolagents does

smolagents belongs to the frameworks family: libraries for building your own agents in code: loop, tools, memory, orchestration. On our grid it ranks #10 of the 28 projects of this family listed in the directory.

A framework is not used as is: it is a library developers build into their own code to describe the agent's tools, decision loop and memory. It requires programming skills, but leaves control over every detail.

You use it from: developer SDK. Usable models: any OpenAI-compatible model and local models (Ollama, llama.cpp, vLLM…). It can run on your own machine or server.

Who is smolagents for?

It is for developers building their own agent or adding agentic AI to a product. Typical tasks people give it:

• build a business agent wired to your APIs
• orchestrate tool and model calls
• add memory and error recovery to an agent

It is a good candidate if your data must stay on your machines and you want the option of a local model, with no API fees.

Access and human control

A framework has no access of its own: the tools you plug in define what the agent can do. Start with read-only tools.

We could not establish whether it asks for human approval before sensitive actions: test it first on an unimportant account or folder.

smolagents pricing

The code is free, under the Apache-2.0 licence.

Getting started with smolagents

1. Install it: the project ships as a Python package (install with pip or uv). The exact command is in the repository README.
2. Pick the model: an API key from a provider, or a local model if your machine has enough graphics memory (the VRAM calculator tells you).
3. Start with the minimal example from the docs, then add one tool at a time and check what the agent does with it.
4. Give it a short, checkable task, review the result and its action log, then raise the difficulty step by step.

Security: risk level

A framework does not protect you by default: approval, minimal rights and sandboxing are up to you.

Three habits: least privilege (minimal rights, dedicated keys), human approval for irreversible actions, a sandbox for code execution. The AI agent security check reviews your setup in a few minutes.

Project activity and releases

Created on December 5, 2024, the huggingface/smolagents repository has 30,029 stars, 3,139 forks and 408 open issues, with 1,059 commits in total. It received changes this month.

Over the last 52 weeks: 82 commits, an average of 1.6 per week.

36 releases in total; 4 in the last twelve months. Latest release: v1.26.0, on May 29, 2026.

smolagents vs other frameworks

GitHub stars of the best-rated open-source projects in the frameworks family. Stars measure attention, not quality: a heavily promoted project collects them fast, a specialised tool will have few.

smolagents and other frameworks at a glance

The 7 best-ranked agents in the same family, 7 of them open source. The score out of 100 only applies to open-source projects; for proprietary services we show the published entry price. A dash marks information the documentation does not state.

How we rated it

Score: 78/100, computed only from public, verifiable data, with no subjective testing or partnership:

• Adoption 30/40: 30,029 stars on a log scale (40 points from about 200,000).
• Activity 23/30: last commit less than a month ago, 2 releases in six months, 82 commits in a year.
• Framework 25/30: licence, default human approval, self-hosting, model choice and documentation site.

The score does not say whether the agent will succeed at your tasks: it measures how solid the project is. The full grid is on the method page.