A curated collection of practical AI projects implementing OCR systems, RAG, AI agents, and other AI use cases.
Smolagents Code Agent
A real-time AI agent that takes any natural language task, reasons through it with a think-act-observe loop, and streams every step live in a Gradio UI.
Overview
Smolagents Code Agent wires together HuggingFace's smolagents CodeAgent and Mistral Small (via LiteLLM) into a Gradio web app. You type a task, the agent writes and executes Python code using DuckDuckGo and Wikipedia, and every reasoning step appears in the UI as it happens. No waiting for a final answer to see what the model was thinking.
Demo

Features
- Real-time trace streaming: every Think, Act, and Observe step appears in the UI as the agent works, powered by
step_callbacksand a background thread queue - Code-first reasoning: the agent writes and executes Python code at each step rather than calling fixed tool APIs
- Two built-in tools:
DuckDuckGoSearchToolfor live web search and a customWikipediaToolthat fetches 5-sentence article summaries - Clean final answer: the agent's conclusion is extracted and displayed separately from the full reasoning trace
- Swappable LLM: change one line in
app.pyto switch from Mistral Small to DeepSeek V3 Flash via OpenRouter (see Usage) - Run/Clear controls: a spinner confirms the agent is active; Clear resets all outputs instantly
Tech Stack
| Layer | Technology |
|---|---|
| Agent framework | HuggingFace smolagents (CodeAgent) |
| LLM | Mistral Small 4 (mistral-small-latest) via LiteLLMModel |
| Web search | DuckDuckGoSearchTool (bundled with smolagents) |
| Knowledge tool | Custom WikipediaTool using the wikipedia package |
| UI | Gradio |
Prerequisites
- Python 3.10 or later
- A Mistral API key. Get one at platform.mistral.ai
Installation
Clone the repository
git clone https://github.com/Sumanth077/Hands-On-AI-Engineering.git
cd Hands-On-AI-Engineering/ai_agents/smolagents_code_agent
Create and activate a virtual environment
Windows
python -m venv .venv
.venv\Scripts\activate
macOS / Linux
python -m venv .venv
source .venv/bin/activate
Install dependencies
pip install -r requirements.txt
Set up environment variables
cp .env.example .env
Open .env and paste your Mistral API key (see Environment Variables).
Usage
python app.py
Open http://127.0.0.1:7860 in your browser, type a task, and click Run Agent.
Example task
Find the latest news about AI agents and summarize the top 3 stories.
Environment Variables
| Variable | Description | Where to get it |
|---|---|---|
MISTRAL_API_KEY |
Authenticates requests to Mistral's API | platform.mistral.ai |
.env.example:
MISTRAL_API_KEY=your_mistral_api_key_here
Project Structure
smolagents-code-agent/
├── app.py # Gradio UI, agent runner, step formatter
├── tools.py # Custom WikipediaTool
├── requirements.txt # Python dependencies
├── .env # Your secrets (git-ignored)
├── .env.example # Template for .env
└── assets/
└── demo.png # Screenshot used in README