fix: recreate README.md with proper YAML frontmatter for HF Spaces

chatkit/README.md

@@ -0,0 +1,68 @@
+---
+title: ClassLens
+emoji: 📊
+colorFrom: green
+colorTo: pink
+sdk: docker
+sdk_version: "latest"
+app_port: 7860
+pinned: false
+license: mit
+short_description: AI-powered exam analysis that transforms Google Form quiz responses into beautiful, actionable reports for teachers.
+---
+
+# 📊 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