How yash17013366/student-academic-advisor-agent works
The product is a student-facing academic advisor: a student is selected in the Streamlit dashboard, the LangGraph workflow builds a profile, analyzes elective eligibility and suitability, and returns ranked recommendations with explanations. Preferences persist as feedback for later profile loads. README and excerpts establish the main orchestration and several data accesses; some dashboard capabilities are documented but their handlers were not sampled, so those links are omitted. The seed-data path is included as a supporting data initialization subsystem.
Main entry points: streamlit_app.py Advisor Dashboard · advisor_graph.py Advisor Graph · academic_profile_agent.py Academic Profile · database.py Database Operations
Components 13
Student Experience
- Advisor Dashboard
ui/streamlit_app.py
Workflow Orchestration
- Advisor Graph
workflow/advisor_graph.py
Advising Agents
- Academic Profile
agents/academic_profile_agent.py - Course Analysis
agents/course_analysis_agent.py - Recommendation
agents/recommendation_agent.py
Data Services
- Preference Memory
memory/preference_memory.py - Database Operations
database/database.py - Advisor SQLite
database/academic_advisor.db - Seed Records
data - Database Seeder
database/seed_database.py
Explanation Integration
- Ollama Client
llm/ollama_client.py - Local Ollama
Other components
- Student
Connections 16
- Student → Advisor Dashboard: uses
README.md - Advisor Dashboard → Advisor Graph: invokes
README.md - Advisor Dashboard → Academic Profile: loads profile
ui/streamlit_app.py - Advisor Dashboard → Preference Memory: reads preferences
ui/streamlit_app.py - Advisor Graph → Academic Profile: runs first
workflow/advisor_graph.py - Advisor Graph → Course Analysis: runs next
workflow/advisor_graph.py - Advisor Graph → Recommendation: runs last
workflow/advisor_graph.py - Academic Profile → Database Operations: reads student records
agents/academic_profile_agent.py - Academic Profile → Preference Memory: loads preferences
agents/academic_profile_agent.py - Course Analysis → Database Operations: loads electives
agents/course_analysis_agent.py - Recommendation → Ollama Client: requests explanations
agents/recommendation_agent.py - Preference Memory → Advisor SQLite: reads and writes
memory/preference_memory.py - Database Operations → Advisor SQLite: queries
database/database.py - Database Seeder → Seed Records: loads records
database/seed_database.py - Database Seeder → Database Operations: creates and seeds
database/seed_database.py - Ollama Client → Local Ollama: sends prompts
llm/ollama_client.py