chatkit/README.md

---
title: ClassLens
emoji: 📊
colorFrom: green
colorTo: pink
sdk: static
app_file: backend/static/report-template.html
license: mit
---

# 📊 ClassLens

**AI-powered exam analysis that transforms Google Form quiz responses into beautiful, actionable reports for teachers.**

## ✨ Features

- 🔗 **Google Forms Integration**: Paste your Google Form response sheet URL
- 📈 **Automatic Grading**: Compare student answers to your answer key
- 📊 **Visual Statistics**: Interactive charts showing score distribution and per-question accuracy
- 🎯 **Detailed Explanations**: Bilingual (English + 中文) explanations for each question
- 👥 **Peer Learning Groups**: AI-suggested groupings for collaborative learning
- 📧 **Email Reports**: Send beautiful HTML reports directly to your inbox
- 🎨 **Beautiful Reports**: Dark theme with Chart.js visualizations

## 🚀 How to Use

1. **Paste your Google Form URL** (the response spreadsheet, not the form itself)
2. **Provide your email** (for receiving the report)
3. **Optionally add answer key** if not embedded in the form
4. **Click analyze** and watch the AI work!

## 🔐 Privacy

- Student names are displayed in full in reports for internal teacher use
- No data is stored permanently
- OAuth tokens are encrypted

## 🛠️ Tech Stack

- **Frontend**: React + Vite + TailwindCSS
- **Backend**: FastAPI + OpenAI ChatKit
- **Charts**: Chart.js
- **AI**: GPT-4.1-mini

## 📝 Example Report Sections

### 📝 Q&A Analysis (題目詳解)
- Reading passages with highlighted key terms
- Per-question explanations with concept tags
- Common mistakes and solving strategies

### 📊 Statistics (成績統計)
- Score distribution bar chart
- Question accuracy doughnut chart
- Individual student performance table

### 👩‍🏫 Teacher Insights (教師建議)
- Overall performance analysis
- Teaching recommendations
- AI prompt for next quiz generation
- Individual student support suggestions

---

Built with ❤️ by [taboola-cz](https://huggingface.co/taboola-cz) for educators