---
title: Pathshala AI
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
python_version: 3.11
pinned: false
---

# Pathshala AI

Pathshala AI is a bilingual AI tutor demo for rural primary students in Nepal.

This Hugging Face Space supports:

- Uploading a text-based PDF textbook directly in the Space
- Asking questions in English, Nepali, or romanized Nepali
- Retrieving relevant textbook portions from the uploaded PDF
- Showing a simple English answer and Nepali explanation
- Generating Nepali quiz questions
- Basic quiz grading

For the full web-app workflow, deploy the FastAPI backend separately and add a Space variable named `BACKEND_URL`.

Without `BACKEND_URL`, the Space can still run the same style of workflow locally. Add these Space secrets/variables to match the web app more closely:

- `LLM_BASE_URL`, `LLM_API_KEY`, `LLM_MODEL` for the AMD/vLLM tutor
- `TRANSLATION_PROVIDER=gemini`, `GEMINI_API_KEY`, `GEMINI_MODEL` for Nepali adaptation and romanized question normalization
- `TRANSLATION_PROVIDER=openai`, `OPENAI_API_KEY`, `OPENAI_MODEL` if you want to use OpenAI for Nepali adaptation instead
- `OCR_PROVIDER=gemini`, `OCR_MAX_PAGES=5` for scanned or custom-font PDFs

Use `LLM_MODEL=Qwen/Qwen2.5-7B-Instruct` to match the project default unless your vLLM endpoint exposes a different model name.