Was ist smolagents?
smolagents ist eine kleine Agentenbibliothek von Hugging Face. Ihre Hauptklasse, CodeAgent, schreibt jede Aktion als kurzes Python-Snippet, das Tools aufruft, Schleifen durchläuft oder Werte berechnet, statt jeweils einen einzelnen JSON-Tool-Call auszugeben. Für den klassischen JSON-Stil gibt es einen ToolCallingAgent.
Weil der Agent Code ausführt, den er selbst geschrieben hat, empfiehlt das README eine Sandbox: E2B, Blaxel, Modal oder Docker. Der eingebaute LocalPythonExecutor ist nach den Worten des README keine Sicherheitsgrenze.
Sie funktioniert mit lokalen Modellen über transformers oder Ollama, mit Inferenzanbietern von Hugging Face und mit kommerziellen APIs über LiteLLM und kann Tools aus MCP-Servern, LangChain und Hub Spaces laden. Das letzte Release, v1.26.0, kam am 29. Mai 2026; die Commits seit August betreffen CI und Sicherheitspflege.
Lohnt sich smolagents?
smolagents taugt eher als Lehrstück denn als Abhängigkeit. Das letzte Release, v1.26.0, kam am 29. Mai 2026, nachdem bis Anfang 2026 etwa zwei pro Monat erschienen waren. Die Commits gingen weiter, aber die seit August pinnen GitHub Actions, schränken Tokens ein und aktualisieren den Docs-Builder; keiner bringt neue Funktionen. Rund 30.000 Sternen stehen 405 offene Issues und 590 offene Pull Requests gegenüber.
Die Idee bleibt tragfähig und gut begründet. Eine Aktion als Code zu schreiben, erlaubt es einem Agenten, mehrere Tool-Aufrufe, Schleifen und Bedingungen in einem Schritt zu verketten; das README zitiert Forschung, die 30 % weniger Schritte und damit weniger Modellaufrufe als beim JSON-Tool-Calling zeigt. Die Kernlogik des Agenten umfasst weniger als 1.000 Zeilen, kurz genug, um sie an einem Nachmittag zu lesen.
Das Sicherheitsmodell ist der Haken. Von einem Modell geschriebenes Python sicher auszuführen, braucht eine echte Sandbox, und der lokale Executor wurde bereits geknackt: CVE-2025-5120 und CVE-2025-9959 waren Sandbox-Ausbrüche im LocalPythonExecutor, und das README sagt inzwischen klar, dass er keine Sicherheitsgrenze ist. E2B, Blaxel, Modal oder Docker bedeuten einen zweiten Dienst, den man betreiben und bezahlen muss.
Für dauerhafte Agenten in der Produktion bieten Pydantic AI und LangGraph typisierte Ausgaben, Persistenz und Tracing, die smolagents dir überlässt, und haben stetigere Release-Zyklen. Die Integration mit dem Hugging Face Hub, bis hin zum Hochladen eines ganzen Agenten in einen Space, bleibt etwas, das keiner der beiden Konkurrenten bietet.
Wo es sich lohnt
Ein ML-Forscher, der offene Modelle bei Agentenaufgaben vergleicht
Benchmarken, wie gut ein Hub-Modell plant und Tools aufruft
Tausche Modelle über den Hub oder Ollama mit demselben CodeAgent und dem Benchmark-Skript des Repos aus; die Bibliothek ist kostenlos, die Kosten sind die Inferenz.
Eine Engineering-Leiterin, die einem Team erklärt, wie Agenten funktionieren
Die Agentenschleife von Anfang bis Ende ohne Framework-Abstraktionen zeigen
Die agents.py mit weniger als 1.000 Zeilen lässt sich in einer Sitzung lesen; kombiniere sie mit einer Docker-Sandbox, damit Übungen nie generierten Code auf Laptops ausführen.
Ein CTO, der ein Agenten-Framework für ein Produkt mit zwei Jahren Horizont abwägt
Entscheiden, ob smolagents zum Standard wird
Fünf Monate ohne Release und 590 offene Pull Requests sind ein Wartungsrisiko; ein Budget für einen späteren Fork oder eine Migration einzuplanen oder ein Framework mit stetigeren Releases zu wählen, ist die vorsichtige Option.
Bevor du dich festlegst
- Einrichtung
- pip install "smolagents[toolkit]" unter Python 3.10 oder neuer; ein erster CodeAgent mit einem Hub- oder API-Modell läuft mit wenigen Zeilen. Ergänze eine Sandbox mit E2B, Modal, Blaxel oder Docker, bevor du nicht vertrauenswürdige Eingaben verarbeitest.
- Integrationen
- Modelle über transformers, Ollama, Inferenzanbieter von Hugging Face und LiteLLM; Tools aus MCP-Servern, LangChain und Hub Spaces; Agenten lassen sich in den Hub hochladen und von dort laden.
- Daten und Datenschutz
- Apache 2.0. Nichts wird irgendwohin gesendet außer an die Modell- und Sandbox-Anbieter, die du konfigurierst. CVE-2025-5120 und CVE-2025-9959 waren Sandbox-Ausbrüche im LocalPythonExecutor, der laut README nicht als Sicherheitsgrenze verwendet werden darf.
- Kosten im großen Maßstab
- Die Bibliothek ist kostenlos; die Rechnung sind Modell-Tokens plus Sandbox-Zeit bei E2B, Modal oder Blaxel oder deine eigenen Docker-Hosts.
- Grenzen
- 405 offene Issues und 590 offene Pull Requests; kein Release seit dem 29. Mai 2026. Keine eingebaute Persistenz oder dauerhafte Ausführung.
Was gut ist
- Das Design mit Code als Aktion spart Modellaufrufe
- Kernlogik unter 1.000 Zeilen
- Jedes Modell über transformers, Ollama, Hub-Anbieter oder LiteLLM
- Tools aus MCP, LangChain und Hub Spaces
Was nicht
- Kein Release seit Mai 2026; die jüngsten Commits sind Pflegearbeiten
- Der lokale Executor hatte CVEs mit Sandbox-Ausbrüchen
- Wenige Produktionsfunktionen: Persistenz, typisierte Ausgaben, Tracing
- 590 offene Pull Requests
Am besten für
Forschende und Lernende, die Code schreibende Agenten erkunden, besonders mit offenen Modellen.
Alternativen zu smolagents
smolagents: häufige Fragen
- Lohnt sich smolagents?
- Ein klarer Beleg, dass Agenten in Code handeln können, der inzwischen in den Wartungsmodus abdriftet, während 590 Pull Requests warten. Wir bewerten es mit 3.5 von 5.
- Was kostet smolagents?
- Kostenlos und Open Source unter der Apache-2.0-Lizenz.
- Welche Nachteile hat smolagents?
- Kein Release seit Mai 2026; die jüngsten Commits sind Pflegearbeiten; Der lokale Executor hatte CVEs mit Sandbox-Ausbrüchen; Wenige Produktionsfunktionen: Persistenz, typisierte Ausgaben, Tracing; 590 offene Pull Requests.
- Für wen eignet sich smolagents?
- Forschende und Lernende, die Code schreibende Agenten erkunden, besonders mit offenen Modellen.
- Was kostet smolagents für ein Team oder im Produktivbetrieb?
- Die Bibliothek ist kostenlos; die Rechnung sind Modell-Tokens plus Sandbox-Zeit bei E2B, Modal oder Blaxel oder deine eigenen Docker-Hosts.
- Ist smolagents sicher für Firmendaten?
- Apache 2.0. Nichts wird irgendwohin gesendet außer an die Modell- und Sandbox-Anbieter, die du konfigurierst. CVE-2025-5120 und CVE-2025-9959 waren Sandbox-Ausbrüche im LocalPythonExecutor, der laut README nicht als Sicherheitsgrenze verwendet werden darf.
- Was sind die besten Alternativen zu smolagents?
- Die nächsten Alternativen, die wir getestet haben, sind Pydantic AI, OpenAI Agents SDK und LangGraph.
Antworten geprüft am 26. Okt. 2026.