# hydenithin/eduvision-ai architecture

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

- Interactive diagram: https://gitdiagram.com/hydenithin/eduvision-ai
- Repository: https://github.com/hydenithin/eduvision-ai

## Overview

EduVision AI turns a question and audience choice into a narrated, animated lesson video. The documented workflow runs asynchronously, exposes progress and lesson data, and serves a downloadable MP4. The single backend file owns the generation stages; the frontend is a separate static page. Several stage-to-stage links are supported by the README’s pipeline description, while source excerpts show only selected implementation calls, so undocumented wiring is omitted.

Main entry points: [`app.py`](https://github.com/hydenithin/eduvision-ai/blob/main/app.py) (Flask endpoints), [`static/index.html`](https://github.com/hydenithin/eduvision-ai/blob/main/static/index.html) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_ui["Web interface<br/>[index.html]"]
end

subgraph group_backend["Lesson pipeline"]
  node_api["Flask endpoints<br/>[app.py]"]
  node_jobs[("Job progress<br/>[app.py]")]
  node_planner["Lesson planning<br/>[app.py]"]
  node_narration["Narration timing<br/>[app.py]"]
  node_lesson_data["Lesson data<br/>[app.py]"]
end

subgraph group_media["Media generation"]
  node_voice["Voice generation<br/>[app.py]"]
  node_manim_script["Animation script<br/>[app.py]"]
  node_sync["Audio-video sync<br/>[app.py]"]
  node_fallback["Fallback renderer<br/>[app.py]"]
  node_video["Final MP4<br/>[app.py]"]
end

node_user(("Learner"))
node_claude{{"Claude API"}}
node_elevenlabs{{"ElevenLabs"}}
node_manim{{"Manim renderer"}}
node_ffmpeg{{"ffmpeg tools"}}

node_user -->|"asks question"| node_ui
node_ui -.->|"submits request"| node_api
node_api -->|"creates job"| node_jobs
node_api -->|"starts pipeline"| node_planner
node_planner -->|"requests lesson"| node_claude
node_planner -->|"produces plan"| node_lesson_data
node_api -->|"builds narration"| node_narration
node_narration -->|"provides text"| node_voice
node_voice -->|"generates speech"| node_elevenlabs
node_api -->|"builds script"| node_manim_script
node_manim_script -->|"renders animation"| node_manim
node_api -->|"synchronizes media"| node_sync
node_sync -->|"merges media"| node_ffmpeg
node_api -->|"uses on failure"| node_fallback
node_fallback -->|"renders video"| node_ffmpeg
node_sync -->|"produces MP4"| node_video
node_fallback -->|"produces MP4"| node_video
node_api -.->|"serves status and video"| node_ui
node_api -->|"serves lesson"| node_lesson_data

click node_ui "https://github.com/hydenithin/eduvision-ai/blob/main/static/index.html"
click node_api "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_jobs "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_planner "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_narration "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_voice "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_manim_script "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_sync "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_fallback "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_video "https://github.com/hydenithin/eduvision-ai/blob/main/app.py"
click node_lesson_data "https://github.com/hydenithin/eduvision-ai/blob/main/app.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_ui toneBlue
class node_api,node_jobs,node_planner,node_narration,node_lesson_data toneAmber
class node_voice,node_manim_script,node_sync,node_fallback,node_video,node_claude toneMint
class node_user,node_elevenlabs,node_manim,node_ffmpeg toneIndigo
```

## Components

### User interface

- [Web interface](https://github.com/hydenithin/eduvision-ai/blob/main/static/index.html): `static/index.html`

### Lesson pipeline

- [Flask endpoints](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Job progress](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Lesson planning](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Narration timing](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Lesson data](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`

### Media generation

- [Voice generation](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Animation script](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Audio-video sync](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Fallback renderer](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`
- [Final MP4](https://github.com/hydenithin/eduvision-ai/blob/main/app.py): `app.py`

### Other components

- **Learner**
- **Claude API**
- **ElevenLabs**
- **Manim renderer**
- **ffmpeg tools**

## Connections

- Learner → Web interface: asks question (evidence: `README.md`)
- Web interface → Flask endpoints: submits request
- Flask endpoints → Job progress: creates job (evidence: `app.py`)
- Flask endpoints → Lesson planning: starts pipeline (evidence: `app.py`)
- Lesson planning → Claude API: requests lesson (evidence: `README.md`)
- Lesson planning → Lesson data: produces plan (evidence: `app.py`)
- Flask endpoints → Narration timing: builds narration (evidence: `app.py`)
- Narration timing → Voice generation: provides text (evidence: `README.md`)
- Voice generation → ElevenLabs: generates speech (evidence: `README.md`)
- Flask endpoints → Animation script: builds script (evidence: `app.py`)
- Animation script → Manim renderer: renders animation (evidence: `README.md`)
- Flask endpoints → Audio-video sync: synchronizes media (evidence: `README.md`)
- Audio-video sync → ffmpeg tools: merges media (evidence: `README.md`)
- Flask endpoints → Fallback renderer: uses on failure (evidence: `README.md`)
- Fallback renderer → ffmpeg tools: renders video (evidence: `app.py`)
- Audio-video sync → Final MP4: produces MP4 (evidence: `README.md`)
- Fallback renderer → Final MP4: produces MP4 (evidence: `README.md`)
- Flask endpoints → Web interface: serves status and video
- Flask endpoints → Lesson data: serves lesson (evidence: `README.md`)
