# smolagents v1.26.0: what's new, verdict & setup Canonical: https://theagenticweekly.com/tools/smolagents · Released: 2026-05-29 · Last verified: 2026-10-25 · Evidence: Tested (smoke test, 2026-10-25, local 3B model (Qwen2.5-3B)) · Vendor: Hugging Face · Official site: https://huggingface.co/docs/smolagents > Hugging Face's small Python library for agents that write and run code; the docs say the core logic fits in roughly a thousand lines. ## Verdict **Hugging Face's small Python library for agents that write and run code; the docs say the core logic fits in roughly a thousand lines.** Good for: - People who want a small hackable agent library - Code-as-action agent experiments Skip if: - You need a full production orchestration platform Tested. Tested 2026-10-25 (America/Chicago). smolagents 1.26.0 passed our one-tool task on a local 3B model: 6 of 6 trials; cold uv install 1.5 s. Test environment: Linux x86_64 virtual machine (Debian 13), 8 vCPU, 15 GiB RAM, no GPU; no vendor account, login or API key. Agent tools were pointed at a local open-weight model (Qwen2.5-3B-Instruct (Q4_K_M) through Ollama 0.40.11), so we tested the tool, not any vendor's hosted models. Not tested: Any vendor-hosted model: everything ran on a local 3B model, so tool-call reliability with frontier models is not measured here; Multi-agent flows, memory, long conversations, streaming, tracing and cloud deployment; Anything beyond one tool and one question; three trials is a smoke test, not a benchmark; The CodeAgent sandboxes (Docker, E2B, Modal) and the hub tools. These are smoke tests, not a benchmark. Full log: /tests/smolagents. Test scope: - Kind and date: smoke test, 2026-10-25 (America/Chicago). Not a benchmark. - What we ran: smolagents 1.26.0 passed our one-tool task on a local 3B model: 6 of 6 trials; cold uv install 1.5 s. - Model used: Qwen2.5-3B-Instruct (Q4_K_M) through Ollama 0.40.11 - Environment: Linux x86_64 virtual machine (Debian 13), 8 vCPU, 15 GiB RAM, no GPU; no vendor account, login or API key - Not tested: Any vendor-hosted model: everything ran on a local 3B model, so tool-call reliability with frontier models is not measured here; Multi-agent flows, memory, long conversations, streaming, tracing and cloud deployment; Anything beyond one tool and one question; three trials is a smoke test, not a benchmark; The CodeAgent sandboxes (Docker, E2B, Modal) and the hub tools. Full test log (commands, versions, raw output): [smolagents 1.26.0: our test log](https://theagenticweekly.com/tests/smolagents) Pricing: Official page, dated. Open-source library; costs come from the model APIs you call. (checked 2026-10-25) ## Best for - [Best AI tool for agent building](https://theagenticweekly.com/best/agent-building) (#-): Minimal Hugging Face library for code-writing agents. ## Key facts The smolagents docs describe an open-source Python library for building and running agents in a few lines of code, with abstractions kept minimal. The repository is Apache-2.0 and the latest release we saw is v1.26.0 on May 29, 2026. - License: Apache-2.0 (per GitHub) - Platforms: Python - Pricing model: Free and open source - Free tier: Free to self-host - Paid plans: None listed for the library - GitHub: huggingface/smolagents: 30,051 stars on 2026-10-25, last push 2026-10-22 - Latest release we saw: v1.26.0, 2026-05-29 - How to start: pip install smolagents and follow the docs' first agent example. - v1.26.0 (2026-05-29): the newest release listed on the official page or repository when we read it on 2026-10-25. ## How to set it up: Get started with smolagents These steps come from the vendor's own pages as read on 2026-10-25. We ran smolagents on 2026-10-25; the test log lists what was and was not covered. 1. **Get access.** pip install smolagents and follow the docs' first agent example. 2. **Check the limits and costs first.** Free to self-host. Open-source library; costs come from the model APIs you call. ## Pros and cons Pros: - Small codebase - Apache-2.0 Cons: - Last release tag we saw is from May 2026 - Our test was one small task on a local 3B model; it does not show behaviour with hosted models or larger jobs ## Alternatives - [Pydantic AI](https://theagenticweekly.com/tools/pydantic-ai): Python agent framework built on Pydantic types, covering agents, realtime voice, image generation and embeddings. - [LangChain](https://theagenticweekly.com/tools/langchain): Open-source framework for building LLM applications and agents in Python and JavaScript, from the team behind LangGraph and LangSmith. - [CrewAI](https://theagenticweekly.com/tools/crewai): Python framework for orchestrating role-playing, autonomous AI agents that work as a crew. - [Langflow](https://theagenticweekly.com/tools/langflow): MIT-licensed visual builder for AI agents and MCP servers with a very large GitHub following. - [Botpress](https://theagenticweekly.com/tools/botpress): Customer-support AI agent platform with a free plan and conversation-based paid plans. - [Gumloop](https://theagenticweekly.com/tools/gumloop): Agent builder for teams; plans start at $37 per month with 20k included credits. - [Lindy](https://theagenticweekly.com/tools/lindy): AI 'employee' builder that connects to your tools; Free plan with $50 in credits that last 7 days, then credit-based plans. - [Microsoft Copilot Studio](https://theagenticweekly.com/tools/copilot-studio): Microsoft's platform for creating and managing custom agents, workflows and apps with no code. - [Relevance AI](https://theagenticweekly.com/tools/relevance-ai): Platform for specialist AI agents for sales, customer success, marketing and HR, with an embedded deployment team. - [Voiceflow](https://theagenticweekly.com/tools/voiceflow): Platform for chat and voice AI agents for customer experience teams. - [LangGraph](https://theagenticweekly.com/tools/langgraph): Low-level framework for building long-running, stateful agents as graphs. - [Vercel AI SDK](https://theagenticweekly.com/tools/vercel-ai-sdk): Vercel's TypeScript SDK that gives one API across many model providers, with streaming and agent helpers. ## FAQ ### What is smolagents? The smolagents docs describe an open-source Python library for building and running agents in a few lines of code, with abstractions kept minimal. The repository is Apache-2.0 and the latest release we saw is v1.26.0 on May 29, 2026. ### Is smolagents free? Free to self-host. Open-source library; costs come from the model APIs you call. Checked 2026-10-25; prices change, so confirm on the vendor's page. ### What license is smolagents under? Its license: Apache-2.0 (per GitHub). Read from the project's own pages on 2026-10-25. ## Sources - [smolagents docs](https://huggingface.co/docs/smolagents) (fetched 2026-10-25) - [smolagents repository (GitHub)](https://github.com/huggingface/smolagents) (fetched 2026-10-25) ## How to cite Agentic Weekly, "smolagents v1.26.0: what's new, verdict & setup", last updated 2026-10-25, https://theagenticweekly.com/tools/smolagents Keep the Reported or Tested label when you quote the verdict.