Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

smolagents by Hugging Face

A minimal Hugging Face library for agents that write and run Python code as their actions.

Agent frameworks and SDKs Code-agent libraryOpen source · Apache-2.0Free to start

Use it in: API / SDK Works with: MCP Local models Multi-agent

Price
Free (OSS)
free and open source
Popularity
#11 in Frameworks
Gid Score 54 / 100 · #11 of 50 ranked frameworks and SDKs
Trend
Growing fast
downloads up 64.0% over 30 days · down 4.7% last week
Development
Quiet lately
latest 1.26.0, 5mo ago
Community
30.4K GitHub stars
193K package downloads a week

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

MakerHugging Face
TypeCode-agent library
First releasedDecember 2024
LicenseApache-2.0
InterfacesPython library
Main languagePython
Open issues and PRs519

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.

Compare prices of all agents

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

Full monthly summary

May brought security fixes, improved deserialization handling, and expanded tool integrations. The month focused on stability and adding new search capabilities.

Action needed: Remote WasmExecutor has been removed
  • 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

All guides

Get started with smolagents

PyPIpip 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

All agent tooling

Listed because each tool documents support for smolagents or for agent frameworks in general. Savings and results depend on your workload.

Compare smolagents with another agent

vs
# 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 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 62 7.2M up 4.8% up 38.9% 30.8K+21/day 0.25.02d ago Free (OSS)

Tools used with smolagents

All tools

What 212 public GitHub projects that depend on smolagents use with it, from their dependency files.

  1. python-dotenv59.0%
  2. Requests58.5%
  3. pandas55.7%
  4. OpenAI Python Library50.5%
  5. NumPy48.6%
  6. Pillow37.7%
  7. Pydantic37.7%
  8. LiteLLM36.3%
  9. Hugging Face Hub36.3%
  10. LangChain34.4%

Used far more often here than in AI-built projects overall: what sets smolagents projects apart.

  1. markdownify26.9% · 186.8×
  2. Gradio22.6% · 94.4×
  3. duckduckgo-search28.3% · 84.3×
  4. Hugging Face Datasets29.2% · 70.3×
  5. LiteLLM36.3% · 63.1×
  6. SymPy18.4% · 52.3×
  7. fsspec18.9% · 42.1×
  8. 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

All AI agent news

  1. Data AgentGid data

    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

Monthly summary · Full changelog

1.26.0
  • 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
1.25.0
  • 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
1.24.0
  • 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
1.23.0
  • 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
1.22.0
  • 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
1.21.3
  • Fix E2BExecutor by pinning e2b-code-interpreter to < 2

smolagents prices over time

Token prices of OpenAI modelsnewest OpenAI model in each family, output price per 1M tokens
OpenAI FlagshipOpenAI Mini

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.

Downloads per dayPyPI, 7-day average 27.6K/day
GitHub starsrunning total 30.4K

Download the raw daily series: smolagents.csv

Gid Score breakdown

Adoption51
Community62
Attention—
Momentum82

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

NumberLatest readingLast checked
Package downloadsNov 17, 2026Nov 19, 06:24 UTC
GitHub starsNov 19, 2026Nov 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:

AgentGid: #11 in Frameworks Gid Score: 54/100 downloads: 193K/week ▲64% 30d

[![AgentGid: #11 in Frameworks](https://agentgid.com/badges/smolagents-rank.svg)](https://agentgid.com/agents/smolagents/)
[![Gid Score: 54/100](https://agentgid.com/badges/smolagents-score.svg)](https://agentgid.com/agents/smolagents/)
[![downloads: 193K/week ▲64% 30d](https://agentgid.com/badges/smolagents-downloads.svg)](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.