How asad-aziz-001/sentellect-learning-through-emotions works
Sentellect is a Flask-based adaptive mathematics learning platform. Students authenticate, complete a DASS-21 assessment, receive a mental-state classification, and are served difficulty-tiered chapter content; quizzes and progress tracking support continued learning. The README documents dashboard analytics and SHAP explanations, plus an emotion-aware Gemini chatbot. The excerpts show authentication, chatbot-to-Gemini calls, and persistence-related code, but omit much route logic, so several workflow links rely on the README’s documented architecture rather than inspected implementations.
Main entry points: app.py Progress tracking · dashboard.html Learning dashboard · questionnaire.html DASS-21 assessment · templates Adaptive chapters
Components 15
Learning workflow
- DASS-21 assessment
templates/questionnaire.html - Mental-state model
app.py - Difficulty adaptation
app.py - Adaptive chapters
templates - Learning dashboard
templates/dashboard.html - Chapter quizzes
templates - Progress tracking
app.py - SHAP explanations
app.py
Accounts and state
- Authentication
app.py - Application data
app.py - Email recovery
app.py
Student support
- AI chatbot
app.py - Gemini service
Student interface
- Web interface
templates
Other components
- Student
Connections 17
- Student → Authentication: signs in
README.md - Authentication → Application data: checks credentials
app.py - Authentication → DASS-21 assessment: routes new users
README.md - DASS-21 assessment → Mental-state model: submits answers
README.md - Mental-state model → Difficulty adaptation: classifies state
README.md - Difficulty adaptation → Adaptive chapters: selects difficulty
README.md - Adaptive chapters → Learning dashboard: informs learning
README.md - Learning dashboard → Chapter quizzes: offers quizzes
README.md - Chapter quizzes → Progress tracking: records performance
README.md - Learning dashboard → Progress tracking: shows progress
README.md - Progress tracking → Application data: persists completion
app.py - Progress tracking → SHAP explanations: supports insights
README.md - Student → AI chatbot: sends messages
README.md - AI chatbot → Gemini service: generates replies
app.py - Student → Email recovery: requests recovery
README.md - Email recovery → Application data: looks up account
app.py - Student → Web interface: uses platform
README.md