- Bump dev version: v1.26.0.dev0
- Add new possible error message to test of LiteLLM providers w/o key
- Fix typo cleanups across docs, examples, and tests
- fix: correct f-string escaping in ToolSerializer.dumps error message
- Revert fix: correct f-string escaping
- Update docstring of LocalPythonExecutor
smolagents by Hugging Face
A minimal Hugging Face library for agents that write and run Python code as their actions.
Use it in: API / SDK Works with: MCP Local models Multi-agent
On this page
Usage data: latest readings Nov 17 to Nov 19, 2026, last checked Nov 19, 06:26 UTC. Date of each number
What smolagents does
smolagents is a code-agent library from Hugging Face, first released in December 2024. You use it through a Python library. Its documentation covers MCP servers, subagents or parallel agents and local models. It can run models from OpenAI, Anthropic, DeepSeek, Qwen, Amazon Bedrock and Azure and others. It is used from Python. It is free and open source (Apache-2.0); you pay only for the models it calls.
Key facts
| Maker | Hugging Face |
|---|---|
| Type | Code-agent library |
| First released | December 2024 |
| License | Apache-2.0 |
| Interfaces | Python library |
| Main language | Python |
| Open issues and PRs | 519 |
Pricing
smolagents is open source and free to use; you pay only for the models and infrastructure it runs on.
Checked Nov 4, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?Yes
- Open source?Yes (Apache-2.0)
- Where you use itPython library
- Supports MCP?Yes
- Model providersopenai, anthropic, deepseek, qwen, amazon, azure, any OpenAI-compatible, local
- Subagents / multi-agent?Yes
- Feature comparisonAll agents
- Closest alternativeLangChain · all alternatives
What's new in smolagents: May 2026
May brought security fixes, improved deserialization handling, and expanded tool integrations. The month focused on stability and adding new search capabilities.
- Fixed high-impact vulnerability in remote executors
- Added Exa as a new search engine option for web searches
- Refactored agent and model deserialization to use a registry pattern instead of importlib
- Removed remote WasmExecutor to streamline the execution environment
2 releases this month · summarised from the official release notes · all months
AgentGid articles about smolagents
Get started with smolagents
| PyPI | pip install smolagents |
|---|
These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.
Add-ons for smolagents: save tokens, add memory and tools
LiteLLM
One gateway for 100+ models with spend tracking, budgets, rate limits and fallbacks.
Langfuse
Traces every model and tool call with its cost and latency, and runs evaluations.
Firecrawl
Turns websites into clean Markdown or structured data the agent can read.
E2B
Runs agent-written code in isolated cloud sandboxes instead of on your machine.
Composio
Connects the agent to 1,000+ apps and APIs with managed sign-in.
Mem0
Adds long-term memory, so the agent remembers users and past work across sessions.
Listed because each tool documents support for smolagents or for agent frameworks in general. Savings and results depend on your workload.
smolagents alternatives
Best smolagents alternatives compared · All agent frameworks and SDKs
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
LangChainLangChain |
79 | 41.1M | up 5.7% | down 2.7% | 150K+76/day | 1.5.22d ago | Free (OSS) | |||
| 2 |
LangGraphLangChain |
75 | 20.1M | up 5.5% | up 29.2% | 45.1K+48/day | 1.2.23yesterday | Free (OSS) | |||
| 3 |
AI SDKVercel |
68 | 47.2M | up 3.9% | up 38.4% | 28.1K+30/day | 7.0.1772d ago | Free (OSS) | |||
| 4 |
Claude Agent SDKAnthropic |
64 | 29.3M | up 5.9% | up 37.6% | 8,588+9/day | 0.2.185yesterday | Free (OSS) | |||
| 5 |
MastraMastra |
63 | 3.7M | up 14.9% | up 49.9% | 29.6K+23/day | 1.84.02d ago | Free (OSS) | |||
| 6 |
OpenAI Agents SDKOpenAI |
62 | 7.2M | up 4.8% | up 38.9% | 30.8K+21/day | 0.25.02d ago | Free (OSS) | |||
Tools used with smolagents
What 212 public GitHub projects that depend on smolagents use with it, from their dependency files.
- python-dotenv59.0%
- Requests58.5%
- pandas55.7%
- OpenAI Python Library50.5%
- NumPy48.6%
- Pillow37.7%
- Pydantic37.7%
- LiteLLM36.3%
- Hugging Face Hub36.3%
- LangChain34.4%
Used far more often here than in AI-built projects overall: what sets smolagents projects apart.
- markdownify26.9% · 186.8×
- Gradio22.6% · 94.4×
- duckduckgo-search28.3% · 84.3×
- Hugging Face Datasets29.2% · 70.3×
- LiteLLM36.3% · 63.1×
- SymPy18.4% · 52.3×
- fsspec18.9% · 42.1×
- Hugging Face Hub36.3% · 39.9×
Ratings from people who use smolagents
No ratings yet. Used smolagents? Rate it and say what it is good and bad at.
smolagents news
-
smolagents downloads up 26% in a week
203K PyPI downloads in the 7 days to Nov 10, against 160K the week before.
What changed: recent smolagents releases
- Bump dev version: v1.25.0.dev0
- Fix import of TokenUsage
- Add MLflow integration doc
- Refactor agent/model deserialization: Replace importlib with registry pattern
- Update _function_type_hints_utils.py: CohereForAI -> CohereLabs
- Fix High impact vulnerability on remote executors
Earlier releases
- Bump version to 1.24
- Fix: Add backward compatibility for deprecated HfApiModel
- Fix typo in secure_code_execution.md
- Update no-stop-sequence model list to support gpt-5.2*
- Fix run_gaia.py token_counts when managed agent is called more than once
- 🌐 [i18n-KO] Translated tools.md to Korean
- Update final answer checks to accept the agent instance
- Dialog mode CLI
- Add Blaxel support for remote code execution
- Proposition: Add exponential backoff with jitter for retries
- Cut generation at stop sequence post generation
- Move executor type validation to python executor creation
- Bump dev version: v1.22.0.dev0
- refactor(PythonExecutor): inherit from ABC and declare abstract methods
- Fix error for GPT-5 not supporting the stop parameter
- Enable return_full_result directly in run method
- Make RunResult json serializable
- Change truncation to remove end rather than middle
- Fix E2BExecutor by pinning e2b-code-interpreter to < 2
smolagents prices over time
smolagents popularity and usage data
smolagents was downloaded 193K times from PyPI in the week ending Nov 17, 2026, down 4.7% on the week before and up 64.0% over the last 30 days compared with the 30 before. The GitHub repository has 30.4K stars, 546 of them added in the last 30 days. The latest stable release is 1.26.0, published May 29, 2026.
Download the raw daily series: smolagents.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| Package downloads | Nov 17, 2026 | Nov 19, 06:24 UTC |
| GitHub stars | Nov 19, 2026 | Nov 19, 06:26 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
smolagents FAQ
How much does smolagents cost?
smolagents is open source and free to use; you pay only for the models and infrastructure it runs on.
Is smolagents open source?
Yes. smolagents is open source, released under the Apache-2.0 license.
How popular is smolagents?
smolagents was downloaded 193K times from PyPI in the week ending Nov 17, 2026, down 4.7% on the week before and up 64.0% over the last 30 days compared with the 30 before. The GitHub repository has 30.4K stars, 546 of them added in the last 30 days. The latest stable release is 1.26.0, published May 29, 2026.
What is the latest version of smolagents?
The latest stable release we track is 1.26.0, published on May 29, 2026.
What are the alternatives to smolagents?
The closest alternatives in the same category by Gid Score are LangChain, LangGraph, AI SDK, Claude Agent SDK.
For the makers of smolagents badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/smolagents/)
[](https://agentgid.com/agents/smolagents/)
[](https://agentgid.com/agents/smolagents/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
PyPI: smolagents. GitHub: huggingface/smolagents. See data sources for how each one is collected.