README.md

---
title: MathPulse AI API
emoji: 🧮
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# MathPulse AI Backend

FastAPI backend for the MathPulse AI educational platform.

## Models Used
- **meta-llama/Meta-Llama-3-8B-Instruct** - AI Math Tutor, Learning Path Generation, Daily Insights
- **facebook/bart-large-mnli** - Student Risk Classification (zero-shot)

## API Endpoints
- `POST /api/chat` - AI Math Tutor conversation
- `POST /api/predict-risk` - Student risk classification
- `POST /api/predict-risk/batch` - Batch risk prediction
- `POST /api/learning-path` - Generate personalized learning paths
- `POST /api/analytics/daily-insight` - Daily classroom insights
- `POST /api/upload/class-records` - Smart document parsing