NotesToQuiz

Inspiration

Most "quiz your notes" tools stop the moment you get something wrong. You find out you don't understand light-dependent reactions, and... that's it. The tool moves on. The gap in your understanding is still there. I wanted to build something that actually closes that loop instead of just testing and walking away.

What it does

NotesToQuiz turns any block of notes into a 5-question quiz on the key concepts — not trivia. But the real differentiator kicks in after you finish: it collects exactly which concepts you got wrong, re-explains them in plain language grounded in your own notes, and re-tests you on just those weak spots. You get a clear before-and-after view showing what you already knew and what you actually improved on, in the same session.

How I built it

• Frontend: React (Vite) + Tailwind CSS — no accounts, no database, everything lives in React state for a fast, frictionless experience
• AI: Groq's API running Llama 3.3 70B, called twice per session with two different jobs — first to generate the quiz from the notes, second to identify weak concepts and generate targeted re-teaching content plus a mini re-quiz
• Deployment: Vercel, with a serverless function (api/groq.js) proxying the Groq calls so the API key never touches the browser

Challenges I ran into

Getting the AI to reliably return strict, parseable JSON for both the quiz and the adaptive re-teach step took careful prompt engineering — I had to explicitly instruct the model to skip any markdown or preamble and return clean JSON only, so the frontend could parse it directly without breaking.

Accomplishments that I'm proud of

Building a genuinely adaptive learning loop — not just a one-shot quiz generator — within a single hackathon push. The re-teach step makes a real, context-aware decision based on actual performance rather than repeating the same content, which was the hardest part to get right and the part I think matters most.

What I learned

Building the adaptive re-teach loop taught me that the real value of AI in education tools isn't the first response — it's the second, context-aware decision based on what a specific learner actually got wrong. A single quiz is a checkpoint. A quiz that responds to your mistakes is closer to actual teaching.

What's next for NotesToQuiz

• Image/OCR support so students can photograph handwritten or textbook notes directly
• Tracking progress across multiple study sessions, not just one
• Subject-specific question styles (e.g. more calculation-based questions for math/science notes)

Built With

• css
• groq
• javascript
• llama
• react
• taliwand
• vercel
• vite