unit4_test / README.md
jhcadfergu's picture
Update README.md
5f9243e verified
---
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