# yash17013366/student-academic-advisor-agent architecture

> Architecture diagram of the GitHub repository yash17013366/student-academic-advisor-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yash17013366/student-academic-advisor-agent
- Repository: https://github.com/yash17013366/student-academic-advisor-agent

## Overview

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: [`ui/streamlit_app.py`](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/ui/streamlit_app.py) (Advisor Dashboard), [`workflow/advisor_graph.py`](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/workflow/advisor_graph.py) (Advisor Graph), [`agents/academic_profile_agent.py`](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/academic_profile_agent.py) (Academic Profile), [`database/database.py`](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/database.py) (Database Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student Experience"]
  node_dashboard["Advisor Dashboard<br/>[streamlit_app.py]"]
end

subgraph group_orchestration["Workflow Orchestration"]
  node_workflow["Advisor Graph<br/>[advisor_graph.py]"]
end

subgraph group_advising["Advising Agents"]
  node_profile["Academic Profile"]
  node_analysis["Course Analysis"]
  node_recommendation["Recommendation"]
end

subgraph group_data["Data Services"]
  node_preference_memory["Preference Memory"]
  node_db_helpers["Database Operations<br/>[database.py]"]
  node_sqlite[("Advisor SQLite")]
  node_seed_data["Seed Records"]
  node_seeder["Database Seeder<br/>[seed_database.py]"]
end

subgraph group_integrations["Explanation Integration"]
  node_ollama_client["Ollama Client<br/>[ollama_client.py]"]
  node_ollama["Local Ollama"]
end

node_student(("Student"))

node_student -->|"uses"| node_dashboard
node_dashboard -->|"invokes"| node_workflow
node_dashboard -->|"loads profile"| node_profile
node_dashboard -->|"reads preferences"| node_preference_memory
node_workflow -->|"runs first"| node_profile
node_workflow -->|"runs next"| node_analysis
node_workflow -->|"runs last"| node_recommendation
node_profile -->|"reads student records"| node_db_helpers
node_profile -->|"loads preferences"| node_preference_memory
node_analysis -->|"loads electives"| node_db_helpers
node_recommendation -->|"requests explanations"| node_ollama_client
node_preference_memory -->|"reads and writes"| node_sqlite
node_db_helpers -->|"queries"| node_sqlite
node_seeder -->|"loads records"| node_seed_data
node_seeder -->|"creates and seeds"| node_db_helpers
node_ollama_client -->|"sends prompts"| node_ollama

click node_dashboard "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/ui/streamlit_app.py"
click node_workflow "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/workflow/advisor_graph.py"
click node_profile "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/academic_profile_agent.py"
click node_analysis "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/course_analysis_agent.py"
click node_recommendation "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/recommendation_agent.py"
click node_preference_memory "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/memory/preference_memory.py"
click node_db_helpers "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/database.py"
click node_sqlite "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/academic_advisor.db"
click node_seed_data "https://github.com/yash17013366/student-academic-advisor-agent/tree/main/data"
click node_seeder "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/seed_database.py"
click node_ollama_client "https://github.com/yash17013366/student-academic-advisor-agent/blob/main/llm/ollama_client.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard toneBlue
class node_workflow toneAmber
class node_profile,node_analysis,node_recommendation toneMint
class node_preference_memory,node_db_helpers,node_sqlite,node_seed_data,node_seeder toneRose
class node_ollama_client,node_ollama,node_student toneIndigo
```

## Components

### Student Experience

- [Advisor Dashboard](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/ui/streamlit_app.py): `ui/streamlit_app.py`

### Workflow Orchestration

- [Advisor Graph](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/workflow/advisor_graph.py): `workflow/advisor_graph.py`

### Advising Agents

- [Academic Profile](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/academic_profile_agent.py): `agents/academic_profile_agent.py`
- [Course Analysis](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/course_analysis_agent.py): `agents/course_analysis_agent.py`
- [Recommendation](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/agents/recommendation_agent.py): `agents/recommendation_agent.py`

### Data Services

- [Preference Memory](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/memory/preference_memory.py): `memory/preference_memory.py`
- [Database Operations](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/database.py): `database/database.py`
- [Advisor SQLite](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/academic_advisor.db): `database/academic_advisor.db`
- [Seed Records](https://github.com/yash17013366/student-academic-advisor-agent/tree/main/data): `data`
- [Database Seeder](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/database/seed_database.py): `database/seed_database.py`

### Explanation Integration

- [Ollama Client](https://github.com/yash17013366/student-academic-advisor-agent/blob/main/llm/ollama_client.py): `llm/ollama_client.py`
- **Local Ollama**

### Other components

- **Student**

## Connections

- Student → Advisor Dashboard: uses (evidence: `README.md`)
- Advisor Dashboard → Advisor Graph: invokes (evidence: `README.md`)
- Advisor Dashboard → Academic Profile: loads profile (evidence: `ui/streamlit_app.py`)
- Advisor Dashboard → Preference Memory: reads preferences (evidence: `ui/streamlit_app.py`)
- Advisor Graph → Academic Profile: runs first (evidence: `workflow/advisor_graph.py`)
- Advisor Graph → Course Analysis: runs next (evidence: `workflow/advisor_graph.py`)
- Advisor Graph → Recommendation: runs last (evidence: `workflow/advisor_graph.py`)
- Academic Profile → Database Operations: reads student records (evidence: `agents/academic_profile_agent.py`)
- Academic Profile → Preference Memory: loads preferences (evidence: `agents/academic_profile_agent.py`)
- Course Analysis → Database Operations: loads electives (evidence: `agents/course_analysis_agent.py`)
- Recommendation → Ollama Client: requests explanations (evidence: `agents/recommendation_agent.py`)
- Preference Memory → Advisor SQLite: reads and writes (evidence: `memory/preference_memory.py`)
- Database Operations → Advisor SQLite: queries (evidence: `database/database.py`)
- Database Seeder → Seed Records: loads records (evidence: `database/seed_database.py`)
- Database Seeder → Database Operations: creates and seeds (evidence: `database/seed_database.py`)
- Ollama Client → Local Ollama: sends prompts (evidence: `llm/ollama_client.py`)
