README.md

metadata

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

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