---
title: GAIA Agent
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "4.36.0"
python_version: "3.11"
app_file: app.py
pinned: false
license: mit
hf_oauth: true
hf_oauth_scopes:
  - read-repos
  - write-repos
  - manage-repos
---

# 🤖 GAIA Agent

A general-purpose AI agent built for the **Hugging Face Agents Course** (Unit 4).

## Features

- **22 Tools** organized by category:
  - 📌 Web & Research: web_search, wikipedia_lookup, arxiv_search, webpage_fetch
  - 📁 Files: read_file, download_file
  - 🎬 Media: youtube_transcript, audio_transcribe, video_frame_analyze
  - 💻 Code Execution: python_executor, javascript_executor, bash_executor
  - 🔢 Mathematics: calculator, symbolic_math, matrix_operations, statistical_analysis
  - 🖼️ Image Processing: image_analyze, image_manipulate, image_annotate, image_ocr

- **ReAct Architecture** using LangGraph
- **GPT-4o** for reasoning and vision tasks

## Setup

1. Set your secrets in the Space settings:
   - `OPENAI_API_KEY`: Your OpenAI API key
   - `TAVILY_API_KEY`: Your Tavily API key (for web search)

2. Click "Run Full Evaluation" to test on all 20 GAIA questions

## Resources

- [Course Page](https://huggingface.co/learn/agents-course/unit4/hands-on)
- [API Docs](https://agents-course-unit4-scoring.hf.space/docs)
- [Leaderboard](https://huggingface.co/spaces/agents-course/Students_leaderboard)