# Project export: TeachMate – Intelligent Classroom Management Platform This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: OpenAI Build Week - Tagline: TeachMate is an AI-powered education platform that generates quizzes, analyzes learning gaps, automates teacher workflows, and delivers personalized insights for students and schools. - Devpost: https://devpost.com/software/teachmate-ai-co-teacher-for-personalized-education - GitHub: not linked - Demo: https://teachmate-hm0c.onrender.com/ - Video: https://www.youtube.com/embed/M0Ic7cZhKpM?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: contributor stats unavailable ## Devpost submission (written by the team) ### Inspiration Teachers spend a significant amount of time on repetitive administrative work such as creating quizzes, grading assessments, writing individual feedback, tracking attendance, organizing classroom resources, and understanding each student's learning progress. These responsibilities reduce the amount of time teachers can dedicate to actual teaching and mentoring. Our goal was to build an AI-powered platform that assists educators instead of replacing them. TeachMate combines AI-powered automation with human decision-making, allowing teachers to remain in control while eliminating repetitive tasks. The result is TeachMate—an AI-powered education platform designed for teachers, students, and school administrators. TeachMate provides three dedicated workspaces: 👩‍🏫 Teacher Portal 👨‍🎓 Student Portal 🏫 Admin Portal Teachers can: Create and manage classes Invite students using secure Invite Codes Create homework and assessments Generate quizzes manually or with AI Upload learning resources Record voice feedback while grading View AI-generated learning insights Communicate with students Students can: Join classes using Invite Codes Complete homework and quizzes View assessments Receive teacher voice feedback Access learning resources Track their own progress Chat with teachers Administrators can: Monitor classes View teacher activity Manage student enrollment Access school-wide analytics Instead of acting as a generic chatbot, AI is integrated directly into everyday classroom workflows. AI Quiz Generator Teachers simply provide: Subject Topic Grade Difficulty Number of Questions AI generates a complete quiz including: MCQs True/False Short Answer Correct Answers Explanations Teachers review every question before publishing. AI Quiz Analysis After students submit quizzes, AI automatically analyzes: Individual student performance Class-wide learning trends Weak concepts Strong concepts Common mistakes Revision recommendations Teachers receive concise summaries instead of manually reviewing every result. AI Voice Feedback Teachers can simply speak while grading answer sheets. AI converts voice into structured feedback containing: Question-wise marks Comments Strengths Weak areas Overall feedback Teachers approve the generated feedback before students receive it. Ask AI Assistant A context-aware AI assistant is available from every page. Teachers can ask: Which students need extra help? Summarize today's submissions. Generate revision quizzes. Explain classroom performance. Students can ask: What should I study today? Explain difficult concepts. Summarize my teacher feedback. Administrators receive school-wide summaries and reports. TeachMate follows a modern full-stack architecture. Frontend React TypeScript Tailwind CSS Backend FastAPI (Python) Database Supabase PostgreSQL Authentication Supabase Authentication AI Providers Primary AI Gemini Fallback Providers OpenRouter Groq If one provider becomes unavailable, the application automatically switches to another provider to maintain uninterrupted AI functionality. OpenAI tools played a significant role in accelerating development. GPT-5.6 We used GPT-5.6 as an engineering and product design partner throughout development. It helped us: Design the overall system architecture Refine the user experience for teachers, students, and administrators Plan the AI workflows Design database relationships Improve API structures Brainstorm classroom automation features Review software design decisions Generate technical documentation Write prompts for AI-powered features Improve project descriptions and presentation materials Rather than writing the application for us, GPT-5.6 helped us iterate on ideas, evaluate implementation approaches, and refine the overall product. Codex We used Codex to accelerate software development by generating and modifying code across the project. Codex helped us: Build React UI components Improve the frontend Implement backend endpoints Connect Supabase with the application Create SQL schemas Generate CRUD operations Build reusable components Refactor existing code Improve TypeScript types Integrate authentication Implement AI feature workflows Speed up debugging and repetitive coding tasks We iteratively reviewed, tested, and refined the generated code before integrating it into the project. One of the biggest challenges was designing AI that genuinely helps teachers without replacing their professional judgment. We intentionally designed TeachMate so that AI never: publishes quizzes automatically, changes marks, sends feedback without approval, or makes academic decisions on behalf of teachers. Another challenge was building a secure role-based architecture where teachers, students, and administrators all share the same platform while accessing only the information they are authorized to see. We also built automatic AI provider fallback so the application remains functional even if one AI provider becomes unavailable. Building TeachMate taught us that successful educational AI is not about replacing educators—it is about reducing repetitive work while keeping teachers in control. We also learned the importance of: scalable database design, secure role-based access, context-aware AI assistants, reliable multi-provider AI orchestration, and iterative development using AI coding tools. Using GPT-5.6 and Codex significantly accelerated development, allowing us to spend more time improving the product experience instead of repetitive implementation work. We model a student's learning progress as a combination of multiple measurable factors. $$ Learning\ Score = 0.35Q + 0.25A + 0.20H + 0.10T + 0.10F $$ Where: (Q) = Quiz Performance (A) = Assessment Performance (H) = Homework Completion (T) = Attendance (F) = Teacher Feedback This overall score helps summarize student progress and can be extended in future versions with additional learning metrics. We plan to expand TeachMate with: Parent Portal QR Code classroom joining Personalized revision plans Smart resource recommendations Offline-first support Advanced learning analytics School-wide AI insights TeachMate demonstrates how AI can meaningfully support education by reducing repetitive work, generating actionable insights, and enabling more personalized learning—while ensuring that teachers remain at the center of every educational decision. ## README (from the GitHub repository) No README available. ## Detected evidence (automated analysis) No repository was indexed for this project. Claimed technologies below could not be checked against code. - FastAPI (technology) — claimed on Devpost, not found in the code - OpenAI (technology) — claimed on Devpost, not found in the code - PostgreSQL (technology) — claimed on Devpost, not found in the code - Python (language) — claimed on Devpost, not found in the code - React (technology) — claimed on Devpost, not found in the code - Supabase (technology) — claimed on Devpost, not found in the code - Tailwind CSS (technology) — claimed on Devpost, not found in the code - TypeScript (language) — claimed on Devpost, not found in the code ## Codebase structure No repository index available. ## Key source files No repository index available; no source files included.