Update README.md

README.md

@@ -9,35 +9,24 @@ app_file: app.py
 pinned: false
 ---
 
-# SPM Exam Simulator (2018–2024) with AI Predictions
+# 📝 SPM Exam Simulator
 
-An open exam simulator for **all Malaysian students** sitting for SPM.  
-Covers **core subjects (BM, English, Math, History, Science, Moral Studies)** and blends **past papers (2018–2024)** with **AI-predicted questions**.
+An AI-powered simulator for **Form 5 SPM students**, covering **2018–2024 past papers**.
 
-## Subjects
-- **Core**: BM, English, Math, History, Science, MoralStudies
-- **Electives (stubbed)**: Accounting, Economics, Business
-
-## Data Format
-- `data/spm_YYYY_subject.json` → questions
-- `data/spm_YYYY_subject_scheme.json` → answer keys
+## 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
 
-Example filenames:
-
-data/spm_2018_BM.json
-data/spm_2018_BM_scheme.json
-data/spm_2018_English.json
-data/spm_2018_English_scheme.json
-...
-data/spm_2024_Science.json
-data?spm_2024_Science_scheme.json
+## Subjects
+- Core: BM, English, Math, History, Science, MoralStudies
 
 
-## Workflow
-1. Place JSON files (2018–2024) into `data/`.
-2. Run:
-   ```bash
-   python merge_questions.py