Open sourcePython · ≈30k stars · Apache-2.0
smolagents
Minimal, code-first agents — the lightweight end of the stack.
Hugging Face's smolagents keeps the agent loop tiny and lets agents write Python code as actions (CodeAct) instead of JSON tool calls. A refreshing counterpoint to heavyweight frameworks.
Pros & cons
Each point cites its sources and says what kind of evidence backs it. A second reviewer tried to refute every claim before it was kept.
Pros
- DocsIntentionally minimal (agent logic in about 1,000 lines of agents.py) and readable, often recommended for learning how agents work.[1][2]
- User reportsPopularized code-as-action (CodeAct) tool calling, which is now widely copied.[1][2]
- DocsModel- and modality-agnostic (transformers, Ollama, Hub providers, LiteLLM), and you can share tools and agents on the Hugging Face Hub.[1]
Cons
- User reportsTightly coupled to its two agent types, so custom state transformations are hard.[1]
- User reportsRunning generated code locally is never fully safe; the maintainer points users to remote sandboxes (E2B/Docker).[1]
- User reportsAn async API has been open as a request since January 2025, and users cite thin docs and examples.[1][2]
- MetadataNo release since v1.26.0 (2026-05-29), with about 410 open issues.[1][2]
- Best for
- Learning agent internals or prototyping code-writing agents with open models from the Hugging Face ecosystem.
- Watch out for
- Run CodeAgent in a remote sandbox, and expect to fork it for non-standard control flow.
Assessed Oct 29, 2026 · adversarially reviewedSuggest a correction
Activity
- Last push
- · yesterday
- Latest release
- v1.26.0
· 5mo ago - Last 90 days
- 0 releases
- · 5mo ago
What's Changed Bump dev version: v1.26.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/2273 Add new possible error message to test of LiteLLM providers w/o key by @albertvillanova in https://github.com/huggingface/smolagents/pull/2275 Fix typo…
- · 6mo ago
What's Changed Bump dev version: v1.25.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/1939 Fix import of TokenUsage by @albertvillanova in https://github.com/huggingface/smolagents/pull/1943 Add MLflow integration doc by @B-Step62 in…
- · 10mo ago
What's Changed Bump version to 1.24 by @aymeric-roucher in https://github.com/huggingface/smolagents/pull/1871 Fix: Add backward compatibility for deprecated HfApiModel by @MohammadKassas143 in https://github.com/huggingface/smolagents/pull/1863 Fix typo in…
- · 1y ago
Improvements ✨ Update final answer checks to accept the agent instance by @Zoe14 in https://github.com/huggingface/smolagents/pull/1648 Dialog mode CLI by @aymeric-roucher in https://github.com/huggingface/smolagents/pull/1540 Add Blaxel support for remote code execution by…
- · 1y ago
What's Changed Bump dev version: v1.22.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/1657 refactor(PythonExecutor): inherit from ABC and declare abstract methods by @HairlessVillager in https://github.com/huggingface/smolagents/pull/1654 Fix error…
Checked against GitHub on Nov 21, 2026. Release notes are shortened to plain text.
In the news
Community · Hugging Face Blog · Dec 4, 2025
In research (1)
Oct 26, 2026 · It deletes the middle of any observation over 20k characters regardless of structure.
Neighbours on the workbench
TypeScript · ≈395k stars · MIT
openclaw/openclaw
The viral open-source personal AI assistant that really does things.
Maintained by OpenClaw Foundation
v2026.11.6releasedTypeScript · ≈285k stars · MIT
deepseek-ai/deepseek-harness
Everything is a Plugin — DeepSeek's open agent harness.
Maintained by DeepSeek
dsh-v0.2.2-rc.5 prereleasedTypeScript · ≈212k stars · Sustainable Use License (fair-code; GitHub reports NOASSERTION)
n8n-io/n8n
Fair-code workflow automation platform with native AI capabilities.
Maintained by n8n-io
n8n@1.123.100releasedConnections
Relations from the Harness Hub knowledge graph, as charted in the State of Harness reports.
Maintained by · 1
- Hugging FaceOrganisation
Similar entries · 3
- CrewAIProject
- CrewAIStartup
- PocketFlowProject
Mentioned in · 1
- DeepMath: A lightweight math reasoning Agent with smolagentsNews · 2025-12-04
