mikuz12/exampass-assistant

★ 17PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

Mindmap

mindmap
  root((exampass-assistant))
    What it does
      Converts lectures to guides
      Generates practice quizzes
      Wrong-answer analysis
      Caches results
    Inputs
      PPTX slides
      DOCX files
      PDF documents
    Outputs
      HTML study guide
      HTML interactive quiz
      Markdown wrong-answer doc
    Audience
      University students
      Exam preppers
    Tech
      Python
      HTML output

mindmap root((exampass-assistant)) What it does Converts lectures to guides Generates practice quizzes Wrong-answer analysis Caches results Inputs PPTX slides DOCX files PDF documents Outputs HTML study guide HTML interactive quiz Markdown wrong-answer doc Audience University students Exam preppers Tech Python HTML output

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Turn a folder of lecture slides into a detailed HTML study guide for each chapter

USE CASE 2

Take an interactive 28-question quiz on any chapter and get instant feedback with explanations

USE CASE 3

Copy the wrong-answer analysis prompt into an AI assistant to get deeper explanations of your mistakes

Tech stack

Python

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Python 3 and input files organized into chapter-named subfolders, first run calls an AI API so an API key is also needed.

Free to use and modify with credit, but cannot be used for any commercial purpose (Creative Commons BY-NC 4.0).

In plain English

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.

Copy-paste prompts

Prompt 1

I have a folder of university lecture slides in PPTX format. Using the exampass-assistant repo, write me a Python script call that processes the folder and generates an HTML study guide and quiz for each chapter.

Prompt 2

Using exampass-assistant's professor-style guide output, rewrite this chapter summary so I can paste it into Anki as flashcard content: [paste chapter guide here]

Prompt 3

The wrong-answer analysis from exampass-assistant gave me this prompt: [paste prompt]. Help me understand the underlying concept behind each of these wrong answers.

Prompt 4

How does exampass-assistant embed images from slides directly into the HTML explanation paragraphs? Show me the relevant part of the codebase.

Prompt 5

I want to extend exampass-assistant to also generate a PDF version of each study guide automatically after the HTML is created. How would I add that?

Open on GitHub → Explain another repo

← mikuz12 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.