---

title: PaperProf emoji: 📄 colorFrom: purple colorTo: blue sdk: gradio sdk_version: 6.16.0 python_version: '3.12' app_file: app.py pinned: false

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

---

PaperProf — AI Study Buddy

PaperProf turns any course PDF into an interactive study session. Upload your lecture notes or textbook, receive auto-generated questions drawn directly from the material, type your answers, and get instant, constructive feedback powered by a local LLM (MiniCPM4-8B).

---

Presentation

📖 Blog / Field Notes: https://paperprof-blog.vercel.app/

Team

• Ryad GAZENAY — LINKEDIN | GITHUB
• Mehdi AZOUZ — LINKEDIN | GITHUB

How it works

PDF upload
    └─► core/parser.py      — extract raw text with PyMuPDF
         └─► core/chunker.py — split text into thematic chunks
              └─► core/questioner.py — LLM generates a question from a chunk
                   └─► student answers
                        └─► core/evaluator.py — LLM evaluates & explains

The LLM (loaded once at startup via model/llm.py) handles both question generation and answer evaluation. Everything runs locally — no API keys needed.

---

File structure

PaperProf/
├── app.py                  # Gradio UI — entry point
├── requirements.txt        # Python dependencies
├── README.md               # This file
├── core/
│   ├── __init__.py
│   ├── parser.py           # PDF → plain text  (PyMuPDF)
│   ├── chunker.py          # plain text → thematic chunks
│   ├── questioner.py       # chunk → study question  (LLM)
│   └── evaluator.py        # (question, chunk, answer) → feedback  (LLM)
└── model/
    ├── __init__.py
    └── llm.py              # singleton LLM wrapper  (MiniCPM4-8B / Transformers)

File roles

---

Setup

# 1. Create a virtual environment
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate

# 2. Install dependencies
pip install -r requirements.txt

# 3. (Optional) override the model or device
export PAPERPROF_MODEL="openbmb/MiniCPM3-4B"   # smaller model for testing
export PAPERPROF_DEVICE="cuda"                  # cuda | mps | cpu | auto

# 4. Launch
python app.py

The Gradio app will open at http://localhost:7860.

---

Usage

1. Click Upload course PDF and choose your file.
2. Click Load PDF — PaperProf parses the document and reports how many chunks were found.
3. Click New Question to get a question generated from a random chunk.
4. Type your answer in the Your Answer box.
5. Click Submit Answer to receive structured feedback.

Repeat steps 3–5 as many times as you like to practice the full material.

---

Requirements

• Python ≥ 3.10
• A GPU with ≥ 10 GB VRAM is recommended for MiniCPM4-8B in bfloat16. CPU inference works but is slow; set PAPERPROF_MODEL to a 4B variant for faster CPU runs.