metadata
title: TalimBot
emoji: 🎓
colorFrom: teal
colorTo: cyan
sdk: docker
pinned: false
license: mit
TalimBot - AI-Powered Student Grouping System
An intelligent educational platform that uses advanced psychology principles and AI to create optimal learning groups for adolescent students (ages 15-16).
Features
- AI-Powered Grouping: Automated group formation using OpenAI GPT-4o
- Educational Psychology: Based on ZPD theory, MBTI complementarity, VARK learning styles
- Teacher Dashboard: Monitor students and manage grouping
- Student Dashboard: Complete personality and learning assessments
- Persian Language: Full RTL support with Vazirmatn font
Tech Stack
- Backend: FastAPI (Python 3.11)
- Frontend: Vanilla JavaScript, Tailwind CSS
- AI: OpenRouter API with GPT-4o
- Deployment: Hugging Face Spaces (Docker)
Usage
- Teacher Login: Use password to access teacher dashboard
- Student Login: Enter national code (کد ملی) to access student dashboard
- Complete Profiles: Students fill MBTI, VARK, AMS, and Cooperative assessments
- Create Groups: Teacher runs AI grouping algorithm
- View Results: Students see their assigned groups
Demo Account
For demonstration purposes, login with:
- National Code: 0921111111
- Name: پریناز عاکف
This account is for demo only and won't be included in grouping.
Configuration
This Space requires the OPENROUTER_API_KEY environment variable to be set in the Secrets section.
Get your free API key at: https://openrouter.ai/keys
License
MIT License - For educational purposes