README.md

---
title: First Agent
emoji: ⚡
colorFrom: pink
colorTo: yellow
sdk: gradio
sdk_version: 5.23.1
app_file: app.py
pinned: false
tags:

- smolagents
- agent
- smolagent
- tool
- agent-course

---

Check out the configuration reference at [spaces-config-reference](https://huggingface.co/docs/hub/spaces-config-reference).

# Unit one: Smolagents

Main course GitHub repository [HuggingFace agents course](https://github.com/gperdrizet/hf-agents-course).

First hands-on course exercise - create a simple agent using Smolagents.

## Running

From you HuggingFace settings dashboard, create a fine-grained access token with inference permissions.

### 1. HuggingFace spaces

[Unit One: Smolagents](https://huggingface.co/spaces/gperdrizet/unit-one-smolagents)

Make your own copy of the space and add your HuggingFace token as `HF_TOKEN` via: settings → Secrets and variables → New secret.

### 2. GitHub codespace

[Unit One: Smolagents](https://github.com/gperdrizet/unit-one-smolagents/tree/main)

Fork a copy of the repository, then add you HuggingFace token as `HF_TOKEN` via: settings → Secrets and variables → Codespaces → New repository secret. Start a new codespace on main.