README.md

---
title: GAIA LangGraph Agent
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
hf_oauth: true

---

# 🏆 Hugging Face Agents Course — Final Project

This repository contains my final project submission for the **Hugging Face Agents Course**.

✅ **Project Overview**
- Multi-step AI agent built with **LangGraph** and **LangChain**
- Integrates:
    - Tavily Search API (for real-time factual retrieval)
    - OpenAI GPT-4 (for advanced reasoning and synthesis)
    - Custom formatter (to prepare exact-match answers for GAIA benchmark)

✅ **Achievements**
- Successfully passed the GAIA benchmark with a high score (≥70%)
- Earned the Hugging Face Certificate of Excellence

---

## ⚠ Important: Paid API Protection

This repository **does NOT include any paid API keys**.

To run the full agent (with GPT-4), you must:
1. Provide your own OpenAI API key (`OPENAI_API_KEY`)  
2. Set it as an environment variable or Hugging Face Space secret