# anushka-s26/multiagent architecture

> Architecture diagram of the GitHub repository anushka-s26/multiagent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anushka-s26/multiagent
- Repository: https://github.com/anushka-s26/multiagent

## Overview

Instructional Agents is a local-LLM course-material authoring and slide-optimization application. Users submit course requests through a web interface or API; the backend runs an ADDIE workflow that generates instructional content and slide materials, with an interactive copilot mode, progress reporting, downloads, and PowerPoint conversion. A separate optimization workflow ingests existing PDFs, builds a searchable slide knowledge base, and supports chapter-level refinement. Edges reflect the excerpts, SOURCE INDEX references, and documented behavior; unsampled UI and workflow details are not inferred.

Main entry points: [`instructional_agents-main/instructional_agents-main/api_server.py`](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/api_server.py) (Course API), [`instructional_agents-main/instructional_agents-main/src/ADDIE.py`](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/ADDIE.py) (ADDIE workflow), [`instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py`](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py) (Optimization workflow), [`instructional_agents-main/instructional_agents-main/src/optimize.py`](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/optimize.py) (Optimization logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["User Access"]
  node_web["Web interface<br/>[app.js]"]
  node_api["Course API<br/>[api_server.py]"]
end

subgraph group_author["Course Authoring"]
  node_addie["ADDIE workflow<br/>[ADDIE.py]"]
  node_slides["Slide authoring<br/>[slides.py]"]
  node_agents["LLM agents<br/>[agents.py]"]
end

subgraph group_optimize["Slide Optimization"]
  node_optimizer["Optimization workflow<br/>[ADDIE_optimize.py]"]
  node_pdf["PDF extraction<br/>[pdf_processor.py]"]
  node_knowledge[("Slide knowledge base")]
  node_refiner["Slide refinement<br/>[slide_refiner.py]"]
  node_optimize_core["Optimization logic<br/>[optimize.py]"]
end

subgraph group_delivery["Output Delivery"]
  node_compiler["LaTeX compiler<br/>[compile.py]"]
  node_pptx["PPTX converter<br/>[latex_to_pptx.py]"]
  node_files["Generated files"]
end

node_user(("Course author"))
node_ollama{{"Ollama"}}

node_user -.->|"submits request"| node_web
node_web -.->|"sends requests"| node_api
node_api -->|"streams progress"| node_web
node_api -->|"runs workflow"| node_addie
node_addie -->|"uses agents"| node_agents
node_addie -->|"runs slide authoring"| node_slides
node_agents -->|"requests generation"| node_ollama
node_api -.->|"runs optimization"| node_optimizer
node_optimizer -->|"extracts slides"| node_pdf
node_optimizer -->|"builds index"| node_knowledge
node_optimizer -->|"uses optimization logic"| node_optimize_core
node_optimize_core -.->|"queries index"| node_knowledge
node_optimize_core -.->|"uses refiner"| node_refiner
node_api -->|"converts output"| node_pptx
node_addie -->|"compiles materials"| node_compiler
node_compiler -->|"uses converter"| node_pptx
node_pptx -->|"writes presentation"| node_files
node_api -->|"serves downloads"| node_files

click node_web "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/frontend/app.js"
click node_api "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/api_server.py"
click node_addie "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/ADDIE.py"
click node_slides "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/slides.py"
click node_agents "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/agents.py"
click node_optimizer "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py"
click node_pdf "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/pdf_processor.py"
click node_knowledge "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/slide_knowledge_base.py"
click node_refiner "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/slide_refiner.py"
click node_optimize_core "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/optimize.py"
click node_compiler "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/compile.py"
click node_pptx "https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/latex_to_pptx.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_web,node_api toneBlue
class node_addie,node_slides,node_agents toneAmber
class node_optimizer,node_pdf,node_knowledge,node_refiner,node_optimize_core toneMint
class node_compiler,node_pptx,node_files toneRose
class node_user,node_ollama toneIndigo
```

## Components

### User Access

- [Web interface](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/frontend/app.js): `instructional_agents-main/instructional_agents-main/frontend/app.js`
- [Course API](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/api_server.py): `instructional_agents-main/instructional_agents-main/api_server.py`

### Course Authoring

- [ADDIE workflow](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/ADDIE.py): `instructional_agents-main/instructional_agents-main/src/ADDIE.py`
- [Slide authoring](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/slides.py): `instructional_agents-main/instructional_agents-main/src/slides.py`
- [LLM agents](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/agents.py): `instructional_agents-main/instructional_agents-main/src/agents.py`

### Slide Optimization

- [Optimization workflow](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py): `instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py`
- [PDF extraction](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/pdf_processor.py): `instructional_agents-main/instructional_agents-main/src/pdf_processor.py`
- [Slide knowledge base](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/slide_knowledge_base.py): `instructional_agents-main/instructional_agents-main/src/slide_knowledge_base.py`
- [Slide refinement](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/slide_refiner.py): `instructional_agents-main/instructional_agents-main/src/slide_refiner.py`
- [Optimization logic](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/optimize.py): `instructional_agents-main/instructional_agents-main/src/optimize.py`

### Output Delivery

- [LaTeX compiler](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/compile.py): `instructional_agents-main/instructional_agents-main/src/compile.py`
- [PPTX converter](https://github.com/anushka-s26/multiagent/blob/main/instructional_agents-main/instructional_agents-main/src/latex_to_pptx.py): `instructional_agents-main/instructional_agents-main/src/latex_to_pptx.py`
- **Generated files**

### Other components

- **Course author**
- **Ollama**

## Connections

- Course author → Web interface: submits request
- Web interface → Course API: sends requests
- Course API → Web interface: streams progress (evidence: `instructional_agents-main/instructional_agents-main/api_server.py`)
- Course API → ADDIE workflow: runs workflow (evidence: `instructional_agents-main/instructional_agents-main/api_server.py`)
- ADDIE workflow → LLM agents: uses agents (evidence: `instructional_agents-main/instructional_agents-main/src/ADDIE.py`)
- ADDIE workflow → Slide authoring: runs slide authoring (evidence: `instructional_agents-main/instructional_agents-main/src/ADDIE.py`)
- LLM agents → Ollama: requests generation (evidence: `instructional_agents-main/instructional_agents-main/src/agents.py`)
- Course API → Optimization workflow: runs optimization
- Optimization workflow → PDF extraction: extracts slides (evidence: `instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py`)
- Optimization workflow → Slide knowledge base: builds index (evidence: `instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py`)
- Optimization workflow → Optimization logic: uses optimization logic (evidence: `instructional_agents-main/instructional_agents-main/src/ADDIE_optimize.py`)
- Optimization logic → Slide knowledge base: queries index (evidence: `instructional_agents-main/instructional_agents-main/src/optimize.py`)
- Optimization logic → Slide refinement: uses refiner (evidence: `instructional_agents-main/instructional_agents-main/src/optimize.py`)
- Course API → PPTX converter: converts output (evidence: `instructional_agents-main/instructional_agents-main/api_server.py`)
- ADDIE workflow → LaTeX compiler: compiles materials (evidence: `instructional_agents-main/instructional_agents-main/src/ADDIE.py`)
- LaTeX compiler → PPTX converter: uses converter (evidence: `instructional_agents-main/instructional_agents-main/src/compile.py`)
- PPTX converter → Generated files: writes presentation (evidence: `instructional_agents-main/instructional_agents-main/src/latex_to_pptx.py`)
- Course API → Generated files: serves downloads (evidence: `instructional_agents-main/instructional_agents-main/api_server.py`)
