Qu’est-ce que smolagents ?
smolagents est une petite bibliothèque d'agents de Hugging Face. Sa classe principale, CodeAgent, écrit chaque action comme un court extrait Python qui appelle des outils, boucle ou calcule des valeurs, au lieu d'émettre un appel d'outil JSON à la fois. Un ToolCallingAgent est disponible pour le style JSON classique.
Parce que l'agent exécute du code qu'il a écrit lui-même, le README dit d'utiliser un bac à sable : E2B, Blaxel, Modal ou Docker. Le LocalPythonExecutor intégré n'est, selon les mots du README, pas une frontière de sécurité.
Il fonctionne avec les modèles transformers locaux ou Ollama, les fournisseurs d'inférence Hugging Face, et les API commerciales via LiteLLM, et peut charger des outils depuis des serveurs MCP, LangChain et les Hub Spaces. La dernière version, v1.26.0, était le 29 mai 2026 ; les commits depuis août sont de la maintenance CI et sécurité.
smolagents vaut-il le coup ?
smolagents est meilleur comme leçon que comme dépendance. Sa dernière version, v1.26.0, est venue le 29 mai 2026 après environ deux par mois jusqu'au début 2026. Les commits ont continué, mais ceux depuis août épinglent les GitHub Actions, cadrent les jetons et mettent à jour le constructeur de documentation ; aucun n'ajoute de fonctions. Face à environ 30 000 étoiles se trouvent 405 issues ouvertes et 590 pull requests ouvertes.
L'idée reste bonne et bien argumentée. Écrire une action en code laisse un agent enchaîner plusieurs appels d'outils, boucles et conditionnels en une étape ; le README cite des recherches montrant 30 % d'étapes en moins, et donc moins d'appels de modèle, que l'appel d'outils JSON. La logique d'agent du cœur fait moins de 1 000 lignes, assez court pour être lu en un après-midi.
Le modèle de sécurité est le hic. Faire tourner du Python écrit par le modèle en sécurité a besoin d'un vrai bac à sable, et l'exécuteur local a déjà été cassé : CVE-2025-5120 et CVE-2025-9959 étaient des évasions de bac à sable dans LocalPythonExecutor, et le README dit désormais clairement que ce n'est pas une frontière de sécurité. E2B, Blaxel, Modal ou Docker ajoutent un second service à faire tourner et à payer.
Pour des agents de production durables, Pydantic AI et LangGraph offrent des sorties typées, la persistance et le traçage que smolagents vous laisse, avec des trains de versions plus réguliers. L'intégration au Hugging Face Hub, dont le push de tout un agent vers un Space, reste quelque chose qu'aucun rival n'égale.
Là où il fait la différence
Un chercheur ML qui compare des modèles ouverts sur des tâches d'agents
Benchmarker à quel point un modèle du Hub planifie et appelle des outils
Échangez les modèles via le Hub ou Ollama avec le même CodeAgent et le script de benchmark du dépôt ; la bibliothèque est gratuite et le coût est l'inférence.
Un responsable d'ingénierie qui enseigne à une équipe comment fonctionnent les agents
Montrer la boucle d'agent de bout en bout sans abstractions de framework
Le agents.py de moins de 1 000 lignes est lisible en une session ; associez-le à un bac à sable Docker pour que les exercices ne lancent jamais de code généré sur les portables.
Un CTO qui pèse un framework d'agents pour un produit de deux ans
Décider s'il faut standardiser sur smolagents
Cinq mois sans version et 590 pull requests ouvertes sont un risque de maintenance ; budgéter pour forker ou migrer plus tard, ou choisir un framework avec des versions plus régulières, est l'option prudente.
Avant de vous engager
- Mise en route
- pip install "smolagents[toolkit]" sur Python 3.10 ou plus récent ; un premier CodeAgent avec un modèle du Hub ou d'API tourne en quelques lignes. Ajoutez un bac à sable E2B, Modal, Blaxel ou Docker avant de lancer une entrée non fiable.
- Intégrations
- Modèles via transformers, Ollama, fournisseurs d'inférence Hugging Face et LiteLLM ; outils depuis des serveurs MCP, LangChain et les Hub Spaces ; les agents peuvent être poussés vers et tirés du Hub.
- Données et confidentialité
- Apache 2.0. Rien n'est envoyé nulle part au-delà des fournisseurs de modèles et de bacs à sable que vous configurez. CVE-2025-5120 et CVE-2025-9959 étaient des évasions de bac à sable dans LocalPythonExecutor, que le README dit de ne pas utiliser comme frontière de sécurité.
- Coût à grande échelle
- La bibliothèque est gratuite ; la facture est les tokens de modèle plus le temps de bac à sable sur E2B, Modal ou Blaxel, ou vos propres hôtes Docker.
- Limites
- 405 issues ouvertes et 590 pull requests ouvertes ; pas de version depuis le 29 mai 2026. Pas de persistance intégrée ni d'exécution durable.
Les points forts
- La conception code-comme-action réduit les appels de modèle
- Logique du cœur de moins de 1 000 lignes
- N'importe quel modèle via transformers, Ollama, fournisseurs du Hub ou LiteLLM
- Outils depuis MCP, LangChain et les Hub Spaces
Les points faibles
- Pas de version depuis mai 2026 ; les commits récents sont de la maintenance
- L'exécuteur local a eu des CVE d'évasion de bac à sable
- Peu de fonctions de production : persistance, sorties typées, traçage
- 590 pull requests ouvertes
Idéal pour
Les chercheurs et apprenants qui explorent les agents qui écrivent du code, surtout avec des modèles ouverts.
Alternatives à smolagents
smolagents : questions fréquentes
- smolagents vaut-il le coup ?
- Une démonstration claire que les agents peuvent agir en code, désormais à la dérive vers le mode maintenance avec 590 pull requests en attente. Nous lui donnons 3.5 sur 5.
- Combien coûte smolagents ?
- Gratuit et open source sous la licence Apache 2.0.
- Quels sont les inconvénients de smolagents ?
- Pas de version depuis mai 2026 ; les commits récents sont de la maintenance; l'exécuteur local a eu des CVE d'évasion de bac à sable; peu de fonctions de production : persistance, sorties typées, traçage; 590 pull requests ouvertes.
- À qui s’adresse smolagents ?
- Les chercheurs et apprenants qui explorent les agents qui écrivent du code, surtout avec des modèles ouverts.
- Combien coûte smolagents pour une équipe ou en production ?
- La bibliothèque est gratuite ; la facture est les tokens de modèle plus le temps de bac à sable sur E2B, Modal ou Blaxel, ou vos propres hôtes Docker.
- smolagents est-il sûr pour les données de l’entreprise ?
- Apache 2.0. Rien n'est envoyé nulle part au-delà des fournisseurs de modèles et de bacs à sable que vous configurez. CVE-2025-5120 et CVE-2025-9959 étaient des évasions de bac à sable dans LocalPythonExecutor, que le README dit de ne pas utiliser comme frontière de sécurité.
- Quelles sont les meilleures alternatives à smolagents ?
- Les alternatives les plus proches que nous avons testées sont Pydantic AI, OpenAI Agents SDK et LangGraph.
Réponses vérifiées le 26 oct. 2026.