How epf-mde/mathutrice works
MATHutrice is a web-based LLM tutor for first-year mathematics. Students navigate learning modules, practise through generated exercises, and build skill progression; teachers also have an upload interface. The graph separates web routing, training orchestration, question formats, evaluation, and persistence. The README documents the home/module experience; sampled app excerpts and the SOURCE INDEX support several runtime links. Upload and some UI capabilities are visible only in documentation or partial route excerpts, so their internal wiring is not expanded.
Main entry points: app.py Web routes · main.py Training and scoring · base_generator.py Generation core · session_generator.py Session planning
Components 21
Web experience
- Web routes
mathutrice/app.py - Home and modules
mathutrice/templates/index.html - Training interface
mathutrice/templates/session.html - Teacher upload
mathutrice/templates/upload.html - Chat interface
mathutrice/templates/chat.html
Training and assessment
- Tutor chat
mathutrice/fonctions_python/chatbot.py - Session planning
mathutrice/fonctions_python/session_generator.py - Training and scoring
mathutrice/fonctions_python/main.py - Gap diagnosis
mathutrice/lacune_evaluation/LLM_as_Evaluator.py
Question generation
- Generation core
mathutrice/fonctions_python/base_generator.py - Multiple choice
mathutrice/fonctions_python/type_questions/qcm_generator.py - Open response
mathutrice/fonctions_python/type_questions/qro_generator.py - Step exercises
mathutrice/fonctions_python/type_questions/steps_generator.py - Fill-in exercises
mathutrice/fonctions_python/type_questions/trous_generator.py - Math verification
mathutrice/fonctions_python/verifier.py
State and integrations
- LLM client
mathutrice/fonctions_python/llm_client.py - Database sessions
mathutrice/database.py - Learning records
mathutrice/models.py
Other components
- Student
- Teacher
- OpenAI-compatible LLM
Connections 32
- Student → Web routes: uses
README.md - Teacher → Web routes: uses
mathutrice/app.py - Web routes → Home and modules: renders
README.md - Web routes → Training interface: renders
mathutrice/app.py - Web routes → Teacher upload: renders
mathutrice/app.py - Web routes → Chat interface: serves
- Web routes → Database sessions: uses
mathutrice/app.py - Web routes → Learning records: queries
mathutrice/app.py - Web routes → Session planning: dispatches
mathutrice/app.py - Web routes → Training and scoring: dispatches
mathutrice/app.py - Web routes → Tutor chat: dispatches
mathutrice/app.py - Web routes → Gap diagnosis: dispatches
mathutrice/app.py - Web routes → Tutor chat: uses
mathutrice/fonctions_python/chatbot.py - Tutor chat → LLM client: calls
mathutrice/fonctions_python/chatbot.py - Session planning → Training and scoring: calls
mathutrice/fonctions_python/session_generator.py - Session planning → Generation core: uses
mathutrice/fonctions_python/session_generator.py - Session planning → Learning records: reads and writes
mathutrice/fonctions_python/session_generator.py - Training and scoring → Multiple choice: generates
mathutrice/fonctions_python/main.py - Training and scoring → Open response: generates
mathutrice/fonctions_python/main.py - Training and scoring → Step exercises: generates
mathutrice/fonctions_python/main.py - Training and scoring → Gap diagnosis: diagnoses
mathutrice/fonctions_python/main.py - Training and scoring → Generation core: updates scores
mathutrice/fonctions_python/main.py - Multiple choice → Generation core: delegates to
mathutrice/fonctions_python/type_questions/qcm_generator.py - Open response → Generation core: delegates to
mathutrice/fonctions_python/type_questions/qro_generator.py - Step exercises → Generation core: delegates to
mathutrice/fonctions_python/type_questions/steps_generator.py - Fill-in exercises → Generation core: delegates to
mathutrice/fonctions_python/type_questions/trous_generator.py - Multiple choice → Math verification: verifies with
mathutrice/fonctions_python/type_questions/qcm_generator.py - Generation core → LLM client: calls
mathutrice/fonctions_python/base_generator.py - Gap diagnosis → Training and scoring: reads reference
mathutrice/lacune_evaluation/LLM_as_Evaluator.py - Gap diagnosis → LLM client: calls
mathutrice/lacune_evaluation/LLM_as_Evaluator.py - LLM client → OpenAI-compatible LLM: sends prompts
mathutrice/fonctions_python/llm_client.py - Database sessions → Learning records: persists
mathutrice/app.py