Smolagents
26,835Minimalist code-agent library that expresses actions as executed Python.
Maturity tier details
Computed tier: 2B(raw score 4.27). Effective tier: 2B.
Facets:documented_in=0evaluated_on=0integration_surfaces=0.5paper_citations=0recent_commit=2stars=1.77
Source of truth:pipeline/maturity/score.py
Description
Hugging Face's minimalist agent framework (≈thousand lines of code) built around CodeAgent, which has the LLM emit Python snippets that are executed against a controlled tool namespace rather than producing JSON tool-call objects. Supervision primitives: a sandboxed Python executor (local or E2B/Docker), an explicit authorized-imports list, planning-step hooks, and trajectory inspection. Action-as-code gives richer composition but shifts the surface from JSON-schema validation to Python-sandbox integrity.
Why it's included
Occupies detection × post_generation × fully_autonomous for the "code-as-action" agent archetype. Distinct enough from JSON-tool-call frameworks that its supervision primitives (authorized-imports, Python sandbox) are worth modeling separately.
Security notes
Open-source (Apache-2.0). CodeAgent executes model-emitted Python — the default local executor only whitelists imports and is not a hard sandbox; for untrusted prompts use the E2B or Docker executor. Review the authorized-imports list per deployment; a broad list effectively grants the model arbitrary local-Python capability.
Addresses failure modes
- Logic error — Correct API use, incorrect logic.
- Fabrication — Generating reference to non-existent APIs, packages, or symbols.