Whisper

a real-time, ai-powered exam revision assistant.

Whisper is a real-time exam revision agent that helps you learn, not just get answers.
it explains concepts, quizzes you, and tracks topic mastery using LLMs and Pathway in a continuous feedback loop.

not a chatbot, but a learning engine.

---

features

• explain any concept in simple language
• generate topic-specific quizzes (MCQ, short answers)
• track your scores and mastery per topic
• real-time adaptive learning using Pathway
• switchable model support: OpenAI, Gemini, Ollama, local models
• beautiful and responsive UI (Next.js + Tailwind)
• user auth with email/password or OAuth login
• fully documented API in docs/api.md

---

how it helps you learn

traditional llm tools give you answers.
whisper helps you build understanding.

• monitors your progress by topic
• adapts questions based on performance
• suggests revisions when needed
• real-time feedback loop (no cron jobs or polling)

---

architecture

core backend

• fastapi — api framework
• pathway — stream computation (topic mastery tracking)
• postgres — persistent store
• ollama, openai, gemini — interchangeable llm backends

frontend

• next.js with tailwindcss
• login + protected routes
• clean, minimal ux focused on learning flow

---

quickstart

# from backend/
make rebuild
make up

# run adaptive learning flow
python3 src/pathway_flow/pathway_main.py