On this page:
Overview
Your Repository
Getting Help
9.1

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-id2

For 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-bob2

You 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.git

If 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.