Assamese / app.py
Sazid2's picture
Create app.py
5ca1bf0 verified
raw
history blame
16.1 kB
# app.py
import os
import io
import sqlite3
from datetime import datetime
import fitz # PyMuPDF
import numpy as np
from PIL import Image
import gradio as gr
import faiss
import pytesseract
from sentence_transformers import SentenceTransformer
import sympy as sp
# Optional: huggingface inference
from huggingface_hub import InferenceApi
# ------------- CONFIG -------------
APP_NAME = "Jajabor – SEBA Assamese Class 10 Tutor (Spaces)"
BASE_DIR = os.path.abspath(os.path.dirname(__file__))
PDF_DIR = os.path.join(BASE_DIR, "pdfs", "class10")
DB_PATH = os.path.join(BASE_DIR, "jajabor_users.db")
# Embedding model - compact for Spaces. Swap if you run on stronger infra.
EMBEDDING_MODEL_NAME = "sentence-transformers/all-MiniLM-L6-v2"
# LLM model to call via Inference API (optional)
# WARNING: not all large models will run under a free plan; see docs.
LLM_MODEL_NAME = "Qwen/Qwen2.5-3B-Instruct" # can change to a hosted model
USE_HF_INFERENCE = True # set False if you plan to load a local small model
CHUNK_SIZE = 600
CHUNK_OVERLAP = 120
TOP_K = 5
HUGGINGFACE_API_TOKEN = os.environ.get("HF_API_TOKEN", None)
if USE_HF_INFERENCE:
if not HUGGINGFACE_API_TOKEN:
print("Warning: HF API token not found in env (HF_API_TOKEN). LLM calls will fail.")
else:
inference = InferenceApi(repo_id=LLM_MODEL_NAME, token=HUGGINGFACE_API_TOKEN)
# ------------- DB helpers -------------
def init_db(db_path=DB_PATH):
os.makedirs(os.path.dirname(db_path), exist_ok=True)
conn = sqlite3.connect(db_path)
cur = conn.cursor()
cur.execute(
"""
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
username TEXT UNIQUE,
created_at TEXT
)
"""
)
cur.execute(
"""
CREATE TABLE IF NOT EXISTS interactions (
id INTEGER PRIMARY KEY AUTOINCREMENT,
user_id INTEGER,
timestamp TEXT,
query TEXT,
answer TEXT,
is_math INTEGER,
FOREIGN KEY(user_id) REFERENCES users(id)
)
"""
)
conn.commit()
conn.close()
def get_or_create_user(username: str):
username = username.strip()
if not username:
return None
conn = sqlite3.connect(DB_PATH)
cur = conn.cursor()
cur.execute("SELECT id FROM users WHERE username=?", (username,))
row = cur.fetchone()
if row:
user_id = row[0]
else:
cur.execute(
"INSERT INTO users (username, created_at) VALUES (?, ?)",
(username, datetime.utcnow().isoformat()),
)
conn.commit()
user_id = cur.lastrowid
conn.close()
return user_id
def log_interaction(user_id, query, answer, is_math: bool):
conn = sqlite3.connect(DB_PATH)
cur = conn.cursor()
cur.execute(
"""
INSERT INTO interactions (user_id, timestamp, query, answer, is_math)
VALUES (?, ?, ?, ?, ?)
""",
(user_id, datetime.utcnow().isoformat(), query, answer, 1 if is_math else 0),
)
conn.commit()
conn.close()
def get_user_stats(user_id):
conn = sqlite3.connect(DB_PATH)
cur = conn.cursor()
cur.execute(
"SELECT COUNT(*), SUM(is_math) FROM interactions WHERE user_id=?", (user_id,)
)
row = cur.fetchone()
conn.close()
total = row[0] or 0
math_count = row[1] or 0
return total, math_count
init_db()
# ------------- PDF loading + RAG -------------
def extract_text_from_pdf(pdf_path: str) -> str:
doc = fitz.open(pdf_path)
pages = []
for page in doc:
txt = page.get_text("text")
if txt:
pages.append(txt)
return "\n".join(pages)
def load_all_pdfs(pdf_dir: str):
texts = []
metas = []
if not os.path.isdir(pdf_dir):
print("PDF_DIR not found:", pdf_dir)
return texts, metas
for fname in os.listdir(pdf_dir):
if fname.lower().endswith(".pdf"):
path = os.path.join(pdf_dir, fname)
print("Reading:", path)
text = extract_text_from_pdf(path)
texts.append(text)
metas.append({"source": fname})
return texts, metas
def split_text(text: str, chunk_size=600, overlap=120):
chunks = []
start = 0
while start < len(text):
end = start + chunk_size
chunk = text[start:end]
if chunk.strip():
chunks.append(chunk)
start = max(end - overlap, end) # avoid infinite loop
return chunks
print("Loading embedding model:", EMBEDDING_MODEL_NAME)
embedding_model = SentenceTransformer(EMBEDDING_MODEL_NAME)
print("Loading PDFs from", PDF_DIR)
all_texts, all_metas = load_all_pdfs(PDF_DIR)
print("Number of PDFs:", len(all_texts))
corpus_chunks = []
corpus_metas = []
for text, meta in zip(all_texts, all_metas):
chs = split_text(text, CHUNK_SIZE, CHUNK_OVERLAP)
corpus_chunks.extend(chs)
corpus_metas.extend([meta] * len(chs))
print("Total chunks:", len(corpus_chunks))
if len(corpus_chunks) > 0:
print("Encoding chunks...")
embs = embedding_model.encode(corpus_chunks, batch_size=32, show_progress_bar=False).astype("float32")
dim = embs.shape[1]
index = faiss.IndexFlatL2(dim)
index.add(embs)
print("FAISS index ready; dim:", dim)
else:
index = None
print("No corpus chunks - upload PDFs to the `pdfs/class10` folder in the repo.")
def rag_search(query: str, k: int = TOP_K):
if index is None:
return []
q_vec = embedding_model.encode([query]).astype("float32")
D, I = index.search(q_vec, k)
results = []
for dist, idx in zip(D[0], I[0]):
if idx == -1:
continue
results.append(
{
"score": float(dist),
"text": corpus_chunks[idx],
"meta": corpus_metas[idx],
}
)
return results
# ------------- LLM helpers -------------
SYSTEM_PROMPT = """
You are "Jajabor", an expert SEBA Assamese tutor for Class 10.
Always prefer to answer in Assamese. If the student clearly asks for English, you may reply in English.
Rules:
- Use ONLY the given textbook context.
- If you are not sure, say: "এই প্ৰশ্নটো পাঠ্যপুথিৰ অংশত স্পষ্টকৈ নাই, সেয়েহে মই নিশ্চিত নহয়।"
- বোঝাপৰা সহজ ভাষাত ব্যাখ্যা কৰা, উদাহৰণ দিয়ক।
- If it is a maths question, explain step-by-step clearly.
"""
def build_rag_prompt(context_blocks, question, chat_history):
ctx = ""
for i, block in enumerate(context_blocks, start=1):
src = block["meta"].get("source", "textbook")
ctx += f"\n[Context {i}{src}]\n{block['text']}\n"
hist = ""
for role, msg in chat_history:
hist += f"{role}: {msg}\n"
prompt = f"""{SYSTEM_PROMPT}
পূৰ্বৰ বাৰ্তাসমূহ:
{hist}
সদস্যৰ প্ৰশ্ন:
{question}
সম্পৰ্কিত পাঠ্যপুথিৰ অংশ:
{ctx}
এতিয়া একেদম সহায়ক আৰু বুজিবলৈ সহজ উত্তৰ দিয়া।
"""
return prompt
def call_llm_via_hf(prompt: str, max_tokens=512):
if not HUGGINGFACE_API_TOKEN:
return "LLM not available: HF API token (env HF_API_TOKEN) is required to call the Inference API."
try:
# huggingface InferenceApi text-generation returns text (model-specific format)
out = inference(inputs=prompt, params={"max_new_tokens": max_tokens, "temperature": 0.3})
# inference result may be a dict or string; try to extract
if isinstance(out, dict) and "generated_text" in out:
return out["generated_text"]
if isinstance(out, list) and len(out) > 0 and "generated_text" in out[0]:
return out[0]["generated_text"]
if isinstance(out, str):
return out
return str(out)
except Exception as e:
return f"LLM call failed: {e}"
def llm_answer_with_rag(question: str, chat_history):
retrieved = rag_search(question, TOP_K)
prompt = build_rag_prompt(retrieved, question, chat_history)
if USE_HF_INFERENCE:
return call_llm_via_hf(prompt)
else:
return "LLM not configured (USE_HF_INFERENCE=False)."
# ------------- OCR + math helpers -------------
def ocr_from_image(img: Image.Image):
if img is None:
return ""
img = img.convert("RGB")
try:
text = pytesseract.image_to_string(img, lang="asm+eng")
except Exception:
text = pytesseract.image_to_string(img)
return text.strip()
def is_likely_math(text: str) -> bool:
math_chars = set("0123456789+-*/=^()%")
if any(ch in text for ch in math_chars):
return True
kws = ["গণিত", "সমীকৰণ", "উদাহৰণ", "প্ৰশ্ন", "বীজগণিত"]
return any(k in text for k in kws)
def solve_math_expression(expr: str):
try:
expr = expr.replace("^", "**")
if "=" in expr:
left, right = expr.split("=", 1)
left_s = sp.sympify(left)
right_s = sp.sympify(right)
eq = sp.Eq(left_s, right_s)
sol = sp.solve(eq)
steps = []
steps.append("প্ৰথমে সমীকৰণ লওঁ:")
steps.append(f"{sp.pretty(eq)}")
steps.append("Sympy ৰ সহায়ত সমাধান পোৱা যায়:")
steps.append(str(sol))
explanation = "ধাপ-ধাপে সমাধান (সংক্ষেপে):\n" + "\n".join(f"- {s}" for s in steps)
explanation += f"\n\nসেয়েহে সমাধান: {sol}"
else:
expr_s = sp.sympify(expr)
simp = sp.simplify(expr_s)
explanation = (
"প্ৰদত্ত গণিতীয় অভিব্যক্তি:\n"
f"{expr}\n\nসরলীকৰণ কৰাৰ পিছত পোৱা যায়:\n{simp}"
)
return explanation
except Exception:
return (
"মই সঠিকভাৱে গণিতীয় অভিব্যক্তি চিনাক্ত কৰিব নোৱাৰিলোঁ। "
"দয়া কৰি সমীকৰণটো অলপ বেছি স্পষ্টকৈ লিখা: উদাহৰণ – 2x + 3 = 7"
)
def speech_to_text(audio):
return ""
def text_to_speech(text: str):
return None
# ------------- Chat logic -------------
def login_user(username, user_state):
username = (username or "").strip()
if not username:
return user_state, "⚠️ অনুগ্ৰহ কৰি প্ৰথমে লগিনৰ বাবে এটা নাম লিখক।"
user_id = get_or_create_user(username)
user_state = {"username": username, "user_id": user_id}
total, math_count = get_user_stats(user_id)
stats = (
f"👤 ব্যৱহাৰকাৰী: **{username}**\n\n"
f"📊 মোট প্ৰশ্ন: **{total}**\n"
f"🧮 গণিত প্ৰশ্ন: **{math_count}**"
)
return user_state, stats
def chat_logic(
username,
text_input,
image_input,
audio_input,
chat_history,
user_state,
):
if not user_state or not user_state.get("user_id"):
sys_msg = "⚠️ প্ৰথমে ওপৰত আপোনাৰ নাম লিখি **Login / লগিন** টিপক।"
chat_history = chat_history + [[text_input or "", sys_msg]]
return chat_history, user_state, None
user_id = user_state["user_id"]
final_query_parts = []
voice_text = speech_to_text(audio_input)
if voice_text:
final_query_parts.append(voice_text)
ocr_text = ""
if image_input is not None:
try:
img = Image.open(io.BytesIO(image_input.read()))
except Exception:
img = image_input
ocr_text = ocr_from_image(img)
if ocr_text:
final_query_parts.append(ocr_text)
if text_input:
final_query_parts.append(text_input)
if not final_query_parts:
sys_msg = "⚠️ অনুগ্ৰহ কৰি প্ৰশ্ন লিখক, কিম্বা ছবি আপলোড কৰক।"
chat_history = chat_history + [["", sys_msg]]
return chat_history, user_state, None
full_query = "\n".join(final_query_parts)
conv = []
for u, b in chat_history:
if u:
conv.append(("Student", u))
if b:
conv.append(("Tutor", b))
is_math = is_likely_math(full_query)
if is_math:
math_answer = solve_math_expression(full_query)
combined_question = (
full_query
+ "\n\nগণিত প্ৰোগ্ৰামে এই ফলাফল দিছে:\n"
+ math_answer
+ "\n\nঅনুগ্ৰহ কৰি শ্রেণী ১০ ৰ শিক্ষাৰ্থীৰ বাবে সহজ ভাষাত ব্যাখ্যা কৰক।"
)
final_answer = llm_answer_with_rag(combined_question, conv)
else:
final_answer = llm_answer_with_rag(full_query, conv)
log_interaction(user_id, full_query, final_answer, is_math)
audio_out = text_to_speech(final_answer)
display_question = text_input or voice_text or ocr_text or "(empty)"
chat_history = chat_history + [[display_question, final_answer]]
return chat_history, user_state, audio_out
# ------------- Gradio UI -------------
with gr.Blocks(title=APP_NAME) as demo:
gr.Markdown(
"""
# 🧭 জাজাবৰ – SEBA অসমীয়া ক্লাছ ১০ AI Tutor (Spaces)
- Upload your SEBA Class 10 PDFs to `pdfs/class10` in this Space repo
- Text + Image (OCR) input
- Math step-by-step solutions
- User login + progress
"""
)
user_state = gr.State({})
with gr.Row():
with gr.Column(scale=1):
gr.Markdown("### 👤 লগিন")
username_inp = gr.Textbox(label="নাম / ইউজাৰ আইডি", placeholder="উদাহৰণ: abu10")
login_btn = gr.Button("✅ Login / লগিন")
stats_md = gr.Markdown("এতিয়ালৈকে লগিন হোৱা নাই।", elem_classes="stats-box")
with gr.Column(scale=3):
chat = gr.Chatbot(label="জাজাবৰ সৈতে কথোপকথন", height=500)
text_inp = gr.Textbox(label="আপোনাৰ প্ৰশ্ন লিখক", lines=2)
with gr.Row():
image_inp = gr.Image(label="📷 প্ৰশ্নৰ ছবি (Optional)", type="file")
audio_inp = gr.Audio(label="🎙️ কণ্ঠস্বৰ প্ৰশ্ন (Stub)", type="numpy")
with gr.Row():
ask_btn = gr.Button("🤖 জাজাবৰক সোধক")
audio_out = gr.Audio(label="🔊 উত্তৰৰ অডিঅ’ (TTS – future)", interactive=False)
login_btn.click(login_user, inputs=[username_inp, user_state], outputs=[user_state, stats_md])
def wrapped_chat(text, image, audio, history, user_state_inner, username_inner):
if user_state_inner and username_inner and not user_state_inner.get("username"):
user_state_inner["username"] = username_inner
return chat_logic(username_inner, text, image, audio, history, user_state_inner)
ask_btn.click(
wrapped_chat,
inputs=[text_inp, image_inp, audio_inp, chat, user_state, username_inp],
outputs=[chat, user_state, audio_out],
)
text_inp.submit(
wrapped_chat,
inputs=[text_inp, image_inp, audio_inp, chat, user_state, username_inp],
outputs=[chat, user_state, audio_out],
)
if __name__ == "__main__":
demo.launch()