---
title: 'HF Agents '
emoji: 🕵🏻‍♂️
colorFrom: indigo
colorTo: indigo
sdk: gradio
sdk_version: 5.39.0
app_file: app.py
pinned: false
hf_oauth: true
hf_oauth_expiration_minutes: 480
---

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

---

Custom agent created for [HF Agents Course](https://huggingface.co/learn/agents-course/unit4/hands-on) for GAIA subset

## Results
- **Best run:** **19/20** tasks (**95%** on course [leaderboard](https://huggingface.co/spaces/agents-course/Students_leaderboard))
- **Average run:** **17/20** tasks (**85%**)

# Technologies
- smolagents - agents framework
- Gemini 2.5 Pro - "brains" of the agent
- [serper.dev](https://serper.dev) - search engine results for web search tool
- custom agent tools using plethora of OSS code and libraries. See more in [tools]()

# Run
1. Create `.env` file (see `.env_example` file)
   - Add `GOOGLE_API_KEY` with Gemini API key
   - Add `SERPER_API_KEY` with serper.dev API key
2. `python app.py` - gradio UI for running agent on course dataset and submitting to leaderboard
3. `python smolagents_agent.py` - gradio UI for testing agent on user input tasks