README.md

metadata

title: Hybrid Quiz Solver
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: docker
pinned: false

Hybrid Quiz Solver

An intelligent quiz-solving agent using LangGraph with Gemini and OpenAI fallback.

Features

• 🔄 Smart API key rotation (Gemini)
• 🛡️ Automatic OpenAI fallback
• 📊 Visualization support
• 🎯 Multi-tool agent (web scraping, code execution, ML, etc.)
• 📝 Timestamped logging

API Endpoints

Health Check

GET /healthz

Submit Quiz

POST /quiz
Content-Type: application/json

{
  "email": "your_email@example.com",
  "secret": "your_secret",
  "url": "https://quiz-url.com/q1.html"
}

Environment Variables

Set these in Space Settings → Variables and secrets:

• GOOGLE_API_KEY - Primary Gemini key
• GOOGLE_API_KEY_2 - Additional Gemini key (optional)
• GOOGLE_API_KEY_3 - Additional Gemini key (optional)
• GOOGLE_API_KEY_4 - Additional Gemini key (optional)
• OPENAI_API_KEY - OpenAI fallback key
• OPENAI_MODEL - OpenAI model (default: gpt-4o-mini)
• TDS_EMAIL - Your email
• TDS_SECRET - Your secret key

Performance

• Average: ~73 seconds per question
• Supports 50+ question chains
• 3-minute timeout per question

Architecture

Quiz URL → Agent → Tools (Web Scraper, Code Executor, etc.)
                ↓
           Gemini (with rotation)
                ↓
           Rate limit? → OpenAI Fallback
                ↓
           Submit Answer → Next Question