README.md

---
title: StudyWithChampAI
emoji: 🏆
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: "5.33.0"
app_file: app.py
pinned: false
python_version: "3.11"
---

# StudyWithChampAI

**Turn notes into quests. Turn studying into progression.**

## Prize Targets

| Prize | Model | Role |
|-------|-------|------|
| 🏆 Best MiniCPM Build | MiniCPM-V 4.6 (1.3B) | OCR, handwriting, diagrams, concept extraction |
| 🏆 Nemotron Hardware Prize | Nemotron 3 Nano 4B | Quest gen, batch questions, Socratic tutor, revision quests |
| 🏆 Tiny Titan | 1.3B + 4B + 3.3B + 1.5B = ~10B | All under 32B |
| 🏆 Best Agent | LearningOrchestrator | 7 cooperating specialist agents |
| 🏆 Best Demo | Voice + multilingual + RPG UI | Boss battles, mastery meters, revision quests |

## Setup

```bash
pip install -r requirements.txt
export HF_API_KEY=hf_...
export FEATHERLESS_API_KEY=fl_...
python app.py
```

## How It Works

1. **Import** — upload a PDF, image, voice recording, or paste notes
2. **MiniCPM-V** reads the material (OCR + concept extraction in one shot)
3. **Nemotron** designs quests and generates batch questions
4. **Battle** — answer questions, earn XP, face the boss at the end
5. **Wrong answer?** Nemotron gives a Socratic hint; translate it to Hindi/Spanish/Bengali
6. **Results** — mastery meters per topic; generate a revision quest targeting weak areas