How 23at/cs360aitutor works
Cs360AItutor is a local-first AI course tutor for course materials, tutoring, quizzes, study planning, and progress tracking. Students use either the Streamlit interface or the command-line flow to work through courses; both route tutoring operations through AITutor, which coordinates document retrieval, persistence, and study planning. The graph also shows the separate progress-observer pattern and connector module. Some paths are supported only by the SOURCE INDEX or README, so unsampled behavior and uncertain wiring are omitted.
Main entry points: ai_tutor.py Tutor coordinator · file_facade.py Document and model facade · study_planner.py Study planning · tutor_db.py Tutoring database
Components 14
Student interfaces
- Streamlit app
app.py - Command-line app
backend/main.py
Learning workflows
- Tutor coordinator
backend/ai_tutor.py - Course materials
backend/ai_tutor.py - Lessons and chat
backend/ai_tutor.py - Quiz workflows
backend/ai_tutor.py - Study planning
backend/study_planner.py - Connector workflows
backend/connector_db.py
AI and documents
- Document and model facade
backend/file_facade.py - Vector retrieval
backend/vector.py
Progress and state
- Tutoring database
backend/database/tutor_db.py - Progress observers
backend/observers.py
Other components
- Student
- Local AI model
Connections 17
- Student → Streamlit app: uses
README.md - Student → Command-line app: uses
backend/main.py - Streamlit app → Tutor coordinator: calls
app.py - Command-line app → Tutor coordinator: calls
backend/main.py - Tutor coordinator → Course materials: manages
backend/ai_tutor.py - Tutor coordinator → Lessons and chat: handles
backend/ai_tutor.py - Tutor coordinator → Quiz workflows: generates
backend/ai_tutor.py - Tutor coordinator → Study planning: delegates
backend/ai_tutor.py - Tutor coordinator → Document and model facade: queries
backend/ai_tutor.py - Tutor coordinator → Tutoring database: persists
backend/ai_tutor.py - Study planning → Tutoring database: reads and writes
backend/study_planner.py - Study planning → Document and model facade: queries
backend/study_planner.py - Document and model facade → Vector retrieval: retrieves
backend/file_facade.py - Document and model facade → Local AI model: invokes
README.md - Connector workflows → Tutoring database: persists
backend/connector_db.py - Connector workflows → Document and model facade: uploads and queries
backend/connector_db.py - Progress observers → Progress observers: notifies observers
backend/observers.py