Smolagents — Lightweight AI Agent Framework

Key Concept: Code Agents

Instead of outputting JSON tool calls, smolagents agents write Python code:

from smolagents import CodeAgent, tool, HfApiModel

@tool
def get_weather(city: str) -> str:
    """Get current weather for a city."""
    return f"Sunny, 22C in {city}"

agent = CodeAgent(tools=[get_weather], model=HfApiModel())
agent.run("What's the weather in Tokyo?")

The agent writes: result = get_weather("Tokyo") and executes it.

Why Code Agents?

• More expressive — loops, conditionals, variables
• Composable — chain tool calls naturally
• Debuggable — read the generated code
• Efficient — fewer LLM calls than ReAct

FAQ

Q: What is Smolagents? A: Hugging Face minimalist agent framework. Build AI agents in ~1000 lines of code with code-based actions, tool calling, and multi-step reasoning.

Q: How do I install Smolagents? A: Check the Quick Use section above for step-by-step installation instructions. Most assets can be set up in under 2 minutes.