README.md

---
title: Jajabor – SEBA Assamese Class 10 AI Tutor
emoji: 🧭
colorFrom: indigo
colorTo: blue
sdk: gradio
sdk_version: "4.44.0"
app_file: app.py
pinned: false
---

# 🧭 Jajabor – SEBA Assamese Class 10 AI Tutor

**Jajabor** is an AI-powered tutor for **SEBA Class 10 Assamese medium** students.  
It reads textbook PDFs, understands photographed questions, solves math step-by-step,  
and answers in **simple Assamese**.

---

# 🚀 Features

### 📚 **RAG Textbook Intelligence**
- Drop SEBA Class 10 PDFs into `pdfs/class10/`
- System auto-reads textbooks using PyMuPDF
- Splits into chunks + builds FAISS search index
- Answers ONLY from textbook content

### 🖼️ **OCR Question Reading**
- Upload a photo of a question  
- Tesseract extracts Assamese + English text  
- Works even with low-quality exam photos

### 🧮 **Math Solver (SymPy)**
- Solves equations  
- Simplifies expressions  
- Shows **step-by-step Assamese explanation**

### 🤖 **LLM Reasoning**
Uses Hugging Face Inference API (configurable):
- default: `Qwen/Qwen2.5-3B-Instruct`
- can change to Gemma, Falcon, Mistral etc.

### 👤 **User Login + Progress Tracking**
Stores:
- number of questions asked  
- math vs non-math ratio  

SQLite database auto-created: `jajabor_users.db`

---

# 📂 Directory Structure