ExamPass-Assistant

ExamPass Assistant is a tool that converts university lecture materials into structured study guides and interactive practice tests. You give it a folder of course files in PPTX, DOCX, or PDF format, organized by chapter, and it produces two HTML files for each chapter: a detailed explanatory guide and an interactive quiz.

The explanatory guide is written in what the README calls a "professor style": it maps out the logic of each chapter, works through formulas step by step, explains what charts and diagrams are showing, and flags the things that tend to appear on exams. If a slide contains a key image, that image gets embedded directly into the relevant paragraph of the guide, so you see the explanation and the visual side by side. The interactive quiz has 28 questions worth 100 points total. You click your answers, submit, and get immediate feedback with correct answers and explanations for each question. Distractor options in the multiple-choice questions are drawn from related concepts rather than made-up wrong answers, which is intended to make the practice more realistic.

The tool also generates a wrong-answer analysis document in Markdown format. This collects every question you got wrong and includes a prompt you can copy into an AI assistant to get further explanation of the concept behind each mistake.

Results are cached after the first run, so if you run it again on the same materials it finishes in seconds. The HTML files open directly in any browser and can be printed to PDF with Ctrl+P.

This repository is a customized fork of an earlier project. The maintainer has added enhancements around deeper content explanation and tighter quiz quality controls. The project is written in Python and licensed under Creative Commons BY-NC 4.0, meaning free to use and modify with credit, but not for commercial purposes.