ExamPass-Assistant

ExamPass Assistant v2.0

Turn lecture slides into exam-ready study materials.

中文

What's new in v2.0 — Notion-style original-PPT cross-reference beside every note, a combined page (notes + quiz in one file with top tabs), self-test answers, mock-exam from a real past paper, smarter pedagogy (Hook → TL;DR → Why → What → How → self-check), a 2× faster streaming pipeline, and a pile of rendering-robustness fixes verified with real-browser screenshots. See the v2.0 changelog.

What is this

An AI-powered exam prep assistant. Drop in lecture PPTs, Word handouts, or PDF readings — it generates:

• Knowledge Guides — structured review notes with MathJax formulas, dual-color highlighting (key points in bold black, explanations in lighter gray), priority tags (must-know / key / frequent / info), an auto table of contents, a Hook → TL;DR → Why → What → How → self-check narrative arc, and collapsible self-test answers
• Original-PPT Cross-Reference (new in v2.0) — a Notion-style right rail pins the rendered slide pages + their original text next to each note, so you can review the source without missing anything; click a heading's [页N] chip and the rail scrolls to that slide; choose density (all pages / key pages / none)
• Combined Page (new in v2.0) — knowledge list and interactive quiz in one HTML with top tabs ( Notes | Quiz)
• Interactive Chapter Quizzes — click to answer, one-click grading, per-question correct/incorrect badges, detailed explanations, and common-mistake warnings. 9 question types incl. calc and code — automatically chosen by subject
• Knowledge Graph — interactive left-root/right-leaf tree with dependency dashed lines, hub-concept stars, hover tooltips, persistent inline note cards (text + paste images), draggable column split, search, and zoom
• Mock Final / Mock-from-Past-Paper — full exam with answer key, blueprint scoring exactly 100 points; mock --ref analyzes a past paper's style and writes brand-new questions in the same shape

Open in any browser. Ctrl+P to print as PDF. MathJax renders formulas perfectly. Responsive down to mobile.

Why

The universal pain of finals week: scattered lecture files, no clear sense of exam priorities, no reliable practice questions.

ExamPass reads your course materials with Claude, extracts key concepts with logical narratives, and generates self-grading quizzes. Students use it to study smarter. Instructors use it to create exercises and assignments in seconds.

Supported Formats

PPTX · DOCX · PDF (with image recognition via multimodal analysis)

Quick Start

git clone https://github.com/WUBING2023/ExamPass-Assistant.git
cd ExamPass-Assistant
pip install -r requirements.txt

Commands

v2.0 streamlined the commands: fast is gone (the default is already fast), and mock folded into final --ref. The PPT cross-reference rail, previously an opt-in flag, is now on by default.

Multi-Agent Pipeline (default)

The default /exampass command orchestrates 5 specialized sub-agents:

All intermediate artifacts land in .epa_work/. The orchestrator (main Claude) only schedules — content is produced by sub-agents following agent cards in agents/.

Use in Your Own Code

…

Project Structure

…

v2.0 Changelog

New features

• Original-PPT cross-reference rail — slide_renderer.py renders whole PDF pages (get_pixmap) and pins them, with their original text (collapsible), beside each note; base64-embedded so the HTML stays a single shareable file. Density is selectable (full / key / none). Headings auto-get [页N] chips that scroll the rail to the matching slide.
• Combined page — save_combined_html puts the knowledge list and the interactive quiz in one file with top tabs ( Notes | Quiz).
• Self-test answers — every in-note checkpoint now carries a collapsible reference answer (ask-then-reveal, active recall).
• mock command — generate a fresh exam that imitates a real past paper (--ref) or the course's inferred exam style.
• Pedagogy upgrade — notes follow a Hook → TL;DR → Why → What → How → self-check arc for "get it in one read."
• 2× faster pipeline — streaming per-chapter review/feedback/revise instead of waiting for every chapter; cache-skip of unchanged chapters.
• Graph — non-agent fallback (so Codex users get a real graph, not cards), draggable left/right split, mobile layout.
• Code styling — modern monospace stack + dark code panel for pseudocode/arrays.

Robustness fixes (all verified with real-browser Playwright screenshots)

• A raw `` and broke the page — now stripped to the body fragment.
• Long display formulas no longer overflow the column / the slide rail (auto-fit + scroll).
• Mobile horizontal-overflow, collapsed slide cards, and quiz cards rendering at 0 height (MathJax-in-hidden-panel) all fixed.

Contributors

• Development & Maintenance: @WUBING2023
• Inspirational Contribution: [email protected]
• Testing: @YeMoonlight
• Testing: @Yuzhihan-zyr

License

CC BY-NC 4.0 — free to use, modify, and share for non-commercial purposes. Commercial use requires a separate license.

Copyright (c) 2025 ExamPass Assistant Contributors