# Hugging Face Smolagents (smolagents) - AgentBreakWatch Reference

> TL;DR Verdict: Hugging Face Smolagents (`smolagents`) is currently at v1.26.0 on PYPI (published 2026-05-29), with a 90-day Stability Score of 86/100 (B+) and MEDIUM schema drift risk across 0 releases in the last 90 days. v1.26.x requires explicit additional_authorized_imports on CodeAgent and context-managed ToolCollection.from_mcp() loading.

## Live Telemetry Metadata
- Canonical Page: https://agentbreakwatch.vercel.app/p/smolagents-python
- Category Hub: https://agentbreakwatch.vercel.app/c/agent-sdks (AI Agent SDKs & Frameworks Breaking-Change Index)
- Package Name: `smolagents`
- Registry: PYPI (https://pypi.org/project/smolagents/)
- GitHub Repository: https://github.com/huggingface/smolagents
- Vendor: Hugging Face
- Latest Live Version: v1.26.0
- Published Date: 2026-05-29T05:08:43.280962Z
- 90-Day Release Count: 0
- Direct Dependencies: 53
- License: MIT
- Stability Score: 86/100 (Grade B+)
- Schema Drift Risk: MEDIUM
- Recommended Exact Pin Command: `pip install "smolagents==1.26.0"`
- Watched Symbols / MCP Tools: CodeAgent, ToolCallingAgent, ToolCollection.from_mcp, InferenceClientModel
- Snapshot Timestamp: 2026-10-24T12:11:27.697Z

## Breaking Change & Schema Drift Summary
v1.26.x requires explicit additional_authorized_imports on CodeAgent and context-managed ToolCollection.from_mcp() loading.

## Migration Diff: Before (Deprecated / Unpinned Pattern)
```
agent = CodeAgent(tools=[], model=HfApiModel())
```

## Migration Diff: After (Verified v1.26.0 Pattern)
```
agent = CodeAgent(tools=[], model=InferenceClientModel(), additional_authorized_imports=["json"])
```

## Recent Verified Releases
- v1.26.0 (published 2026-05-29) [LATEST]
- v1.25.0 (published 2026-05-14)
- v1.24.0 (published 2026-01-16)
- v1.23.0 (published 2025-11-17)
- v1.22.0 (published 2025-09-25)
- v1.21.3 (published 2025-09-01)