🕵️‍♂️ Hugging Face Agents Course — Final Agent

Note on model class names: older tutorials mentioned HuggingFaceHubServerModel / HfApiModel.
In current smolagents, that Hub backend is called InferenceClientModel.

Important (2026): Creating new Gradio Spaces on Hugging Face now requires a PRO plan (or an eligible older account for ZeroGPU).
If you cannot create a Space, use the local runner below — it still submits to the official Unit 4 leaderboard.

What you need for the certificate

1. Run the agent (Space or local submit_answers.py).
2. Submit answers to the scoring API.
3. Check your score on the student leaderboard.

Set up your Hugging Face API token (HF_TOKEN)

A) On a Hugging Face Space (if you have PRO / eligible ZeroGPU)

1. Open your Space → Settings → Variables and secrets.
2. Add secret HF_TOKEN = your token from https://huggingface.co/settings/tokens.

B) On your computer (works without Spaces PRO)

1. Create a token at https://huggingface.co/settings/tokens.
2. Copy .env.example → .env and paste:

Run locally (4 steps)

1. Open a terminal in this project folder.
2. Create & activate a virtual environment:

• Windows PowerShell: .venv\Scripts\Activate.ps1
• macOS / Linux: source .venv/bin/activate

1. Install dependencies:

1. Add your token, then either:

Push to a Hugging Face Space (if your account allows Gradio)

1. Create a Space at https://huggingface.co/new-space (Gradio + CPU basic / ZeroGPU).
2. Upload app.py, requirements.txt, and README.md.
3. Add secret HF_TOKEN.
4. Open Certificate Evaluation → Log in → Submit.
5. Score ≥ 30% → claim your certificate.

Optional: push with CLI

Project files

hf-agents-course-final/
├── app.py              # Agent + Gradio UI (chat + certificate submit)
├── submit_answers.py   # Local leaderboard submission (no Space needed)
├── requirements.txt    # Python packages
├── README.md           # This file
├── .env.example        # Template for local HF_TOKEN
└── .gitignore