Apppublic

CoderLakshman/Final_Assignment_Template

sourceHugging Faceupdated 5mo agoView on Hugging Face

0likes

App README

<h3 align="center">Agents Course Final Project</h3>

<p align="center" style="width:80%"> Final hands-on assignment for the Hugging Face Agents course. In this project I built a multi-agent solution, evaluated it against questions from the General AI Assistants (GAIA) benchmark (level one only), and got creative with some agent and tool improvements. </div>

About The Project

Achieving 30 points for the certification was relatively easy with the template provided and a powerful enough LLM. However, evaluation revealed the unique types of implementation challenges with AI agents. Some of which include...

—Cost
—Reliability
—Response Times

![HF Space Screenshot](https://huggingface.co/spaces/civerson916/FinalAssignmentTemplate)

![Langfuse Screenshot](https://huggingface.co/learn/agents-course/unit4/hands-on)

Beyond what looks like a smolagents guided tour, you can find the following in this repo...

—Research agent armed with Google search via Serper and both Audo and Video Understanding via Gemini
—Chess agent leveraging my board_to_fen fork and a Stockfish API.
—Langfuse setup boilerplate, a working example. This is an absolute must.
—Pydantic settings for type safety, centralized, and encapsulated config.
—Basic parallel agent task execution, compatible with smolagents and the Gradio UI.

Getting Started

To get a local copy up and running follow these steps.

Prerequisites

—python
—pip
—git

Installation

1.Get an API key for the following services: OpenRouter, Gemini, Serper, and Langfuse. The HF username and space are only used when submitting answers for evaluation, but must be present to startup. If you run this in your own HF space, these will already be set for you.
2.Clone the repo and install packages

   git clone https://github.com/civerson/smolagents-gaia-final.git
   pip install -r requirements.txt

1.Enter your API keys in a .env or set them as follows

   OPENROUTER_API_KEY = 'ENTER YOUR API'
   GEMINI_API_KEY = 'ENTER YOUR API'
   SERPER_API_KEY = 'ENTER YOUR API'
   LANGFUSE_PUBLIC_KEY = 'ENTER YOUR API'
   LANGFUSE_SECRET_KEY = 'ENTER YOUR API'
   USERNAME = 'ENTER YOUR HF USERNAME'
   SPACE_ID = 'ENTER YOUR HF SPACE'

1.Run the app

   python app.py

1.Change git remote url to avoid accidental pushes to base project

   git remote set-url origin github_username/repo_name
   git remote -v # confirm the changes