🤗 smolagents

2 guides covering common problems, patterns, and production issues in smolagents.

Smolagents is HuggingFace's lightweight Python agent framework. It offers two modes — CodeAgent (writes and executes Python to call tools) and ToolCallingAgent (JSON-based tool calls) — and works with any HuggingFace model, local Ollama models, or any OpenAI-compatible API.

  • CodeAgent: writes Python to use tools — more flexible and powerful
  • ToolCallingAgent: JSON tool calls — safer for production
  • @tool decorator for defining custom tools in one line
  • HuggingFace Hub, Ollama, and OpenAI-compatible model support
  • Minimal dependencies and a small, auditable codebase
Visit official site →
smolagents March 31, 2026 1 min

Running Smolagents with Local Models: Ollama, HuggingFace Hub, and the Tradeoffs

Smolagents was built by HuggingFace with open-source and local models as a first-class concern. Unlike frameworks that assume GPT-4 or Claude, Smolagents is designed to run on models you control — on ...

Read guide →
smolagents March 31, 2026 1 min

Smolagents CodeAgent vs ToolCallingAgent: Which One Should You Use?

Smolagents ships two agent types with fundamentally different execution models. Most frameworks hide this choice. Smolagents makes it explicit.

Read guide →
Other Tools

Stay sharp as AI tools evolve

New guides drop regularly. Get them in your inbox — no noise, just signal.