How tokaelfawey/hcai_project works
The repository is an interactive academic-planning simulator: students set constraints, explore bounded course drafts, and retain control through actions such as locking, rejecting, undoing, and accepting proposals. A separate schedule-and-chat workflow supports schedule changes and uploaded-material workload analysis. The main app and core modules are excerpted; links to unsampled features are included only where the README or source index supports them.
Main entry points: academic_decision_simulator.py Decision Simulator · Dashboard.py Streamlit Dashboard · course_planner.py Course Planner · gemini_llm.py Gemini Adapter
Components 15
Student Interface
- Streamlit Dashboard
Acdemic stimulor implemenation/Dashboard.py - Accessible Themes
Acdemic stimulor implemenation/project_theme.py
Course Planning
- Course Planner
Acdemic stimulor implemenation/course_planner.py - Course Catalog
Acdemic stimulor implemenation/data/course_catalog.csv - Course Drafts
Acdemic stimulor implemenation/course_planner.py
Schedule Simulation
- Decision Simulator
Acdemic stimulor implemenation/academic_decision_simulator.py - Gemini Adapter
Acdemic stimulor implemenation/gemini_llm.py - Schedule State
Acdemic stimulor implemenation/data/academic_simulator_schedule.json - Chat History
Acdemic stimulor implemenation/data/academic_simulator_chat.json - Schedule Proposals
Acdemic stimulor implemenation/academic_decision_simulator.py
Material Analysis
- Document Workload Analyzer
Acdemic stimulor implemenation/document_workload_analyzer.py - Material Vectors
Acdemic stimulor implemenation/data/course_material_chroma
Other components
- Student
- Gemini API
- Course Materials
Connections 15
- Student → Streamlit Dashboard: uses
README.md - Streamlit Dashboard → Decision Simulator: creates
Acdemic stimulor implemenation/Dashboard.py - Streamlit Dashboard → Accessible Themes: applies
Acdemic stimulor implemenation/Dashboard.py - Streamlit Dashboard → Gemini Adapter: initializes
Acdemic stimulor implemenation/Dashboard.py - Decision Simulator → Course Planner: delegates planning
Acdemic stimulor implemenation/academic_decision_simulator.py - Course Planner → Course Catalog: loads courses
Acdemic stimulor implemenation/course_planner.py - Course Planner → Course Drafts: generates
README.md - Decision Simulator → Document Workload Analyzer: uses analysis
Acdemic stimulor implemenation/academic_decision_simulator.py - Student → Course Materials: provides
README.md - Document Workload Analyzer → Material Vectors: stores vectors
Acdemic stimulor implemenation/document_workload_analyzer.py - Decision Simulator → Schedule State: persists schedule
Acdemic stimulor implemenation/academic_decision_simulator.py - Decision Simulator → Chat History: persists chat
- Decision Simulator → Schedule Proposals: prepares changes
Acdemic stimulor implemenation/academic_decision_simulator.py - Gemini Adapter → Gemini API: requests completion
Acdemic stimulor implemenation/gemini_llm.py - Decision Simulator → Gemini Adapter: requests response