Assignment 3: Quiz Generator
Due: November 5, 11:59PM
Overview
Math quizzes that write themselves. A Learner picks a topic and a level, anywhere from Grade 1 fractions to GRE Quantitative Reasoning, and an LLM builds a fresh quiz on the spot. Every answer is graded the moment it is submitted, with step-by-step feedback and a Socratic tutor that nudges the learner when they are stuck.
The application supports:
Any topic, any level. Grade 1 through GRE Quantitative Reasoning, optionally wrapped in a theme such as soccer or Harry Potter.
Quizzes from your own material (RAG). Upload notes, a worksheet, or a textbook chapter. The application chunks and indexes it, retrieves the relevant passages, and generates questions grounded in that material, citing the passage each question came from.
Instant, detailed grading. Step-by-step feedback as soon as an answer is submitted.
Socratic tutor. When the learner is stuck, the tutor gives hints that guide them toward the answer instead of revealing it.
This is a pair project. You will work in an assigned pair of two students, and the pair shares a single repository. The list of pairs is posted on Piazza.
Your Repository
A private GitLab repository has already been created for each pair; you do not need to create one. Its name is built from the two partners’ UMD directory IDs:
https://gitlab.cs.umd.edu/cmsc389a/fall2026/student-repos/p3/math-quiz-id1-id2For example, if your directory ID is alice1 and your partner’s is bob2, your repository is:
https://gitlab.cs.umd.edu/cmsc389a/fall2026/student-repos/p3/math-quiz-alice1-bob2You can also find it by signing in to gitlab.cs.umd.edu, where the project will be listed among your projects. Clone it with:
mkdir -p ~/cmsc389A
cd ~/cmsc389A
git clone git@gitlab.cs.umd.edu:cmsc389a/fall2026/student-repos/p3/math-quiz-id1-id2.gitIf you have not set up your GitLab account and SSH key yet, do that first; see Before the First Class.
Getting Help
If you cannot see your repository, if the pair listed on Piazza is wrong, or if you get a permission error when cloning, post on Piazza or come to office hours. Do this as soon as you notice the problem: extension requests caused by not being able to obtain the assignment will be denied.