How maheshleo4/vector_quiz works
VectorQuiz is a web app for generating multiple-choice quizzes with Gemini or Groq, then scoring submissions and exporting quiz content. The main flow is user input in the frontend, API validation and generation, and returned questions; scoring and export are separate API operations. The README documents frontend scoring/export features, but the tree contains only index.html, so client-side wiring and implementation details are uncertain. Backend behavior is supported by sampled source.
Main entry points: app.py API routes · llm_config.py LLM client · index.html Quiz interface
Components 14
Web client
- Quiz interface
frontend/index.html
Quiz API
- API routes
backend/app.py - Quiz validation
backend/app.py - Quiz scoring
backend/app.py - Quiz export
backend/app.py - Key template
backend/llm_config.py
Quiz generation
- LLM client
backend/llm_config.py - Model registry
backend/llm_config.py - Prompt and parsing
backend/llm_config.py - Provider clients
backend/llm_config.py
External providers
- Gemini API
- Groq API
Other components
- Quiz user
- .env file
Connections 13
- Quiz user → Quiz interface: uses
- Quiz interface → API routes: API requests
- API routes → LLM client: generates quizzes
- API routes → Quiz validation: validates submissions
- API routes → Quiz scoring: scores answers
- API routes → Quiz export: formats exports
- API routes → Key template: creates template
- Key template → .env file: writes
- LLM client → Model registry: selects model
- LLM client → Prompt and parsing: builds and validates
- LLM client → Provider clients: dispatches generation
- Provider clients → Gemini API: generates content
- Provider clients → Groq API: generates content