Smolagents Starter Project

A minimal starter project for building AI agents using the smolagents library - the simplest framework for building powerful agents.

Features

• 🚀 Simple and minimal setup
• 🤖 Support for any LLM (OpenAI, Anthropic, Hugging Face models)
• 🛠️ First-class support for Code Agents
• 🤗 Hub integrations for tools

Setup

1. Clone this repository

git clone https://github.com/sanjeed5/smolagents-starter.git
cd smolagents-starter

2. Create and activate a virtual environment using uv

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

3. Install dependencies

uv sync

4. Copy the example environment file and configure your environment variables

cp .env.example .env

5. Edit .env with your API keys and configuration

Go to https://aistudio.google.com/ to get a free GEMINI API key.

Or you can just use HfApiModel without any model for free.

Usage

uv run agent.py

Modify as per your requirements. Refer the documentation for more details.

License

MIT