""" FastAPI main server for IITM LLM Quiz Solver. """ import os import logging import asyncio from typing import Dict, Any, Optional from fastapi import FastAPI, HTTPException, Request from fastapi.responses import JSONResponse from pydantic import BaseModel, Field, field_validator import uvicorn # Try to load .env file if python-dotenv is available try: from dotenv import load_dotenv load_dotenv() except ImportError: pass # python-dotenv is optional from app.solver import solve_quiz from app.utils import validate_secret from app.browser import cleanup_browser # Configure logging logging.basicConfig( level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s' ) logger = logging.getLogger(__name__) # Get secret from environment EXPECTED_SECRET = os.getenv("QUIZ_SECRET", "default_secret_change_me") # Lifespan context manager for startup and shutdown from contextlib import asynccontextmanager @asynccontextmanager async def lifespan(app: FastAPI): """Lifespan context manager for startup and shutdown.""" # Startup logger.info("Application starting up...") yield # Shutdown logger.info("Shutting down, cleaning up browser...") await cleanup_browser() # Initialize FastAPI app with lifespan app = FastAPI( title="IITM LLM Quiz Solver", description="API endpoint to automatically solve dynamic quiz tasks", version="1.0.0", lifespan=lifespan ) class QuizRequest(BaseModel): """Request model for quiz solving.""" email: str = Field(..., description="User email address") secret: str = Field(..., description="Secret key for authentication") url: str = Field(..., description="Quiz page URL") @field_validator('email') @classmethod def validate_email(cls, v): if not v or '@' not in v: raise ValueError('Invalid email format') return v @field_validator('url') @classmethod def validate_url(cls, v): if not v or not v.startswith(('http://', 'https://')): raise ValueError('Invalid URL format') return v @app.get("/") async def root(): """Root endpoint.""" return { "message": "IITM LLM Quiz Solver API", "version": "1.0.0", "endpoints": { "/solve": "POST - Solve a quiz", "/health": "GET - Health check", "/demo": "POST - Demo endpoint" } } @app.get("/health") async def health_check(): """Health check endpoint.""" return {"status": "healthy"} @app.get("/env-check") async def env_check(): """ Check environment variables status (returns JSON). Useful for verifying configuration. """ quiz_secret = os.getenv("QUIZ_SECRET") openai_key = os.getenv("OPENAI_API_KEY") openrouter_key = os.getenv("OPENROUTER_API_KEY") port = os.getenv("PORT", "8000") return { "status": "ok", "variables": { "QUIZ_SECRET": { "set": quiz_secret is not None, "length": len(quiz_secret) if quiz_secret else 0, "preview": f"{quiz_secret[:4]}...{quiz_secret[-4:]}" if quiz_secret and len(quiz_secret) > 8 else "***" if quiz_secret else None }, "OPENAI_API_KEY": { "set": openai_key is not None, "length": len(openai_key) if openai_key else 0, "preview": f"{openai_key[:7]}...{openai_key[-4:]}" if openai_key and len(openai_key) > 11 else "***" if openai_key else None, "valid_format": openai_key.startswith("sk-") if openai_key else False }, "OPENROUTER_API_KEY": { "set": openrouter_key is not None, "length": len(openrouter_key) if openrouter_key else 0, "preview": f"{openrouter_key[:7]}...{openrouter_key[-4:]}" if openrouter_key and len(openrouter_key) > 11 else "***" if openrouter_key else None, "valid_format": openrouter_key.startswith("sk-or-") if openrouter_key else False }, "PORT": { "set": True, "value": port } }, "ready": quiz_secret is not None, "llm_enabled": any([openai_key, openrouter_key]) } @app.post("/solve") async def solve_quiz_endpoint(request: QuizRequest): """ Main endpoint to solve a quiz. Validates secret and solves the quiz recursively. """ try: # Validate secret if not validate_secret(request.secret, EXPECTED_SECRET): logger.warning(f"Invalid secret provided for email: {request.email}") raise HTTPException( status_code=403, detail={"error": "forbidden"} ) logger.info(f"Solving quiz for {request.email} at {request.url}") # Solve quiz with timeout try: result = await asyncio.wait_for( solve_quiz(request.url, request.email, request.secret), timeout=180.0 # 3 minutes ) return result except asyncio.TimeoutError: logger.error("Quiz solving timed out") raise HTTPException( status_code=504, detail={"error": "Request timeout - quiz solving took too long"} ) except Exception as e: logger.error(f"Error solving quiz: {e}", exc_info=True) raise HTTPException( status_code=500, detail={"error": str(e)} ) except HTTPException: raise except ValueError as e: logger.error(f"Validation error: {e}") raise HTTPException( status_code=400, detail={"error": "Invalid request format", "message": str(e)} ) except Exception as e: logger.error(f"Unexpected error: {e}", exc_info=True) raise HTTPException( status_code=500, detail={"error": "Internal server error", "message": str(e)} ) @app.post("/demo") async def demo_endpoint(request: QuizRequest): """ Demo endpoint for testing. Same as /solve but with more lenient error handling. """ try: # Validate secret (can be more lenient for demo) if not validate_secret(request.secret, EXPECTED_SECRET): logger.warning(f"Invalid secret in demo request") return JSONResponse( status_code=403, content={"error": "forbidden"} ) logger.info(f"Demo: Solving quiz for {request.email} at {request.url}") # Solve quiz try: result = await asyncio.wait_for( solve_quiz(request.url, request.email, request.secret), timeout=180.0 ) return result except asyncio.TimeoutError: return JSONResponse( status_code=504, content={"error": "Request timeout"} ) except Exception as e: logger.error(f"Error in demo: {e}", exc_info=True) return JSONResponse( status_code=500, content={"error": str(e)} ) except ValueError as e: return JSONResponse( status_code=400, content={"error": "Invalid request format", "message": str(e)} ) except Exception as e: logger.error(f"Unexpected error in demo: {e}", exc_info=True) return JSONResponse( status_code=500, content={"error": "Internal server error", "message": str(e)} ) if __name__ == "__main__": port = int(os.getenv("PORT", 8000)) uvicorn.run( "app.main:app", host="0.0.0.0", port=port, log_level="info" )