README.md

---
title: Template Final Assignment
emoji: 🕵🏻‍♂️
colorFrom: indigo
colorTo: indigo
sdk: gradio
sdk_version: 5.25.2
app_file: app.py
pinned: false
hf_oauth: true
# optional, default duration is 8 hours/480 minutes. Max duration is 30 days/43200 minutes.
hf_oauth_expiration_minutes: 480
---

# 🕵️‍♂️ Super Agent: The AI Answer Machine 🚀

Welcome to **Super Agent** – the AI agent built to be evaluated on [GAAI](https://huggingface.co/papers/2311.12983) benchmark to complete the [AI agents](https://huggingface.co/learn/agents-course/unit0/introduction) course by [Hugging Face](https://huggingface.co/)!

---

## ✨ Features

- 🔍 **Web Search**: Finds up-to-date info using DuckDuckGo or Tavily.
- 📊 **Excel & Data Extraction**: Reads and analyzes Excel files.
- 🎧 **Audio & YouTube Transcripts**: Extracts transcripts from audio files and YouTube videos.
- 🧮 **Math Tools**: Adds numbers, checks commutativity, and more.
- 🧠 **RAG-Ready**: Retrieval-Augmented Generation for smarter, more accurate answers.
- 🤖 **LLM Integration**: Works with Google Gemini, HuggingFace, and OpenAI models.
- 🛡️ **Exact Match Mode**: Answers are evaluated for exactness.
- 🛠️ **Extensible Tooling**: Easily add new tools for more superpowers.
- ⏳ **Gemini Rate Limiter**: Includes a rate limiter implementation for Gemini, perfect for handling free tier API limits.

---

## 🧩 Supported Tools

- `web_search` – Search the web for up-to-date info
- `extract_data_from_excel` – Download and parse Excel files
- `extract_transcript_from_youtube` – Get YouTube video transcripts
- `extract_transcript_from_audio` – Get transcripts from audio files
- `add_numbers_in_list` – Add up numbers
- `check_commutativity` – Test if a binary operation is commutative