LLM Analysis – Autonomous Quiz Solver

What is it?

LLM Analysis – Autonomous Quiz Solver is an AI agent that automatically solves multi-step data science quizzes.
It can scrape websites, download files, execute Python code for analysis, and submit answers without human intervention.

The system uses LangGraph and LangChain for orchestration, Gemini 2.5 Flash for reasoning, and FastAPI as the serving layer.

---

How it Works

FastAPI receives a quiz URL via a POST request. A LangGraph-based agent reads and understands the quiz instructions. The agent autonomously chooses tools to scrape data, download files, generate and run Python code, install dependencies, and submit answers. If the response includes another quiz URL, the agent continues the loop. The agent terminates automatically when no further quiz URL is provided.

---

How to Run

1. Environment Setup

Create a .env file in the project root:

EMAIL=your.email@example.com
SECRET=your_secret
GOOGLE_API_KEY=your_gemini_api_key

2. Install Dependencies and Start Server

pip install uv
uv sync
uv run playwright install chromium
uv run main.py

3. Trigger the Agent

curl -X POST http://localhost:7860/solve \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your.email@example.com",
    "secret": "your_secret",
    "url": "https://tds-llm-analysis.s-anand.net/demo"
  }'