Update README.md

README.md

@@ -9,22 +9,30 @@ app_file: app.py
 pinned: false
 ---
 
-# 📝 SPM Exam Simulator
-
-An AI-powered simulator for **Form 5 SPM students**, covering **2018–2024 past papers**.
-
-## Features
-- ✅ Upload past papers (PDF) → Extracts questions with OCR
-- ✅ Handles **Paper 1 (Essay)** separately for practice with AI feedback
-- ✅ **Paper 2 (MCQ Simulator)** with auto-scoring + predicted questions
-- ✅ AI Agents:
-  - **AnalyzerAgent** → scores answers
-  - **CoachAgent** → essay feedback
-  - **PredictiveAgent** → forecasts 2025–2026 trends
-- ✅ Ignores empty JSON files safely
-
-## Subjects
-- Core: BM, English, Math, History, Science, MoralStudies
+# SPM Exam Simulator (local PDF → JSON → SQLite → Simulator)
+
+This repo provides:
+- `ocr_agent.py` — PDF → JSON (extracts text + images).
+- `merge_questions.py` — merge processed JSONs into `questions.json` and populate `exam.db`.
+- `app.py` — Gradio-based Paper 2 (MCQ) simulator that shows questions + diagrams, lets students select A/B/C/D, and reveals score + AI advice after submission.
+- `agents.py` — Analyzer & Coach (ZhipuAI) wrappers.
+
+## Quick overview
+1. Put your PDFs under a local folder (recommended: `data/raw/<subject>/<year>/paper2.pdf`).
+2. Run OCR to produce processed JSONs.
+3. Run `merge_questions.py` to create `questions.json` and populate `exam.db`.
+4. Start the simulator: `python app.py`.
+
+## Requirements
+- Python 3.10+ (the Docker image used Python 3.10)
+- Install Tesseract OCR (system binary).
+  - **Windows**: download and install [Tesseract for Windows] (e.g. from UB Mannheim)
+  - **Linux (Debian/Ubuntu)**: `sudo apt-get install tesseract-ocr`
+  - **macOS**: `brew install tesseract`
+- Install Python packages:
+  ```bash
+  python -m pip install -r requirements.txt
+