README.md

metadata

title: ClassLens
emoji: 📊
colorFrom: green
colorTo: pink
sdk: docker
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 for educators