README.md

metadata

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