---
title: Template Final Assignment
emoji: 🕵🏻‍♂️
colorFrom: indigo
colorTo: indigo
sdk: gradio
sdk_version: 5.25.2
app_file: app.py
pinned: false
hf_oauth: true
hf_oauth_expiration_minutes: 480
---

# GAIA Agent — Final Assignment

A `smolagents` CodeAgent built to answer GAIA Level 1 questions for the HF
Agents course final assignment. Uses HF Inference Providers for the LLM and a
small toolset for browsing, files, audio, and images. Self-consistency +
verifier pass on top to maximize exact-match score.

## Where things live

| File          | Purpose                                                  |
| ------------- | -------------------------------------------------------- |
| `app.py`      | Gradio UI + run-and-submit pipeline                      |
| `agent.py`    | `GaiaAgent` class — self-consistency + verifier          |
| `tools.py`    | 8 tools (search, browse, wiki, YT, file, table, ASR, VLM)|
| `config.py`   | **All non-secret settings** (model IDs, knobs)           |
| `requirements.txt` | Python deps                                         |

## Secrets (Space → Settings → Variables and secrets)

| Secret           | Purpose                                                  |
| ---------------- | -------------------------------------------------------- |
| `HF_TOKEN`       | HF Inference Providers (uses your Pro quota)             |
| `SERPER_API_KEY` | Web search via serper.dev                                |

That's it. No model IDs in secrets — edit `config.py` for those.

## Tuning

Open `config.py` and change values directly:

- `AGENT_MODEL_ID` — the LLM brain. Default DeepSeek-V3.
- `SELF_CONSISTENCY_N` — independent attempts per question. 3 = balanced, 5 = max.
- `MAX_STEPS` — agent reasoning steps per attempt.
- `VLM_MODEL_ID` — vision model for image questions.

Any of the constants in `config.py` can also be overridden by a Space env var
of the same name, but that's optional.