# nousresearch/kanban-video-pipeline architecture

> Architecture diagram of the GitHub repository nousresearch/kanban-video-pipeline, 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/nousresearch/kanban-video-pipeline
- Repository: https://github.com/nousresearch/kanban-video-pipeline

## Overview

This repository is a creative-production project: its documented workflow turns a video brief into scene specifications, rendered clips, and an assembled final video, using Hermes Kanban agents. The agent orchestration and editor assembly are documented rather than implemented in the sampled source; scene renderers, capture scripts, creative guidance, and a media-analysis CLI are present. Dashed edges with null evidence mark documented stages whose implementation is not in this tree.

Main entry points: [`render-scripts`](https://github.com/nousresearch/kanban-video-pipeline/tree/main/render-scripts) (Scene renderers), [`README.md`](https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md) (Cinematographer), [`render-scripts/scene-05/capture.js`](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/capture.js) (Scene 5 capture), [`render-scripts/scene-03/capture.js`](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-03/capture.js) (Scene 3 capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Creative planning"]
  node_brief["Video brief<br/>[brief.md]"]
  node_director["Director<br/>[README.md]"]
  node_cinematographer["Cinematographer<br/>[README.md]"]
  node_brand["Brand guide<br/>[brand-guide.md]"]
  node_emotional["Emotional DNA<br/>[emotional-dna.md]"]
  node_editor["Editor<br/>[README.md]"]
end

subgraph group_production["Scene production"]
  node_renderer["Scene renderers"]
  node_ascii["ASCII scenes<br/>[render.py]"]
  node_ascii2["Additional ASCII scenes<br/>[render.py]"]
  node_ascii4["Terminal scene<br/>[render.py]"]
  node_ascii6["Completion scene<br/>[render.py]"]
  node_ascii7["Logo scene<br/>[render.py]"]
  node_p5scene3["Generative scene 3<br/>[sketch.html]"]
  node_capture3["Scene 3 capture<br/>[capture.js]"]
  node_p5scene5["Generative scene 5<br/>[sketch.html]"]
  node_capture5["Scene 5 capture<br/>[capture.js]"]
  node_clips["Rendered clips"]
  node_final["Final video"]
end

subgraph group_media["Media tools"]
  node_audiofeatures["Scene 5 audio features<br/>[extract_audio.py]"]
  node_analyzer["Media analyzer<br/>[media_analyze.py]"]
end

node_creator(("Video creator"))
node_hermes["Hermes Kanban"]

node_creator -->|"writes"| node_brief
node_brief -->|"guides decomposition"| node_director
node_director -->|"hands off"| node_cinematographer
node_cinematographer -->|"specifies scenes"| node_renderer
node_brand -->|"guides visuals"| node_cinematographer
node_emotional -->|"guides tone"| node_cinematographer
node_renderer -.->|"renders"| node_ascii
node_renderer -.->|"renders"| node_ascii2
node_renderer -.->|"renders"| node_ascii4
node_renderer -.->|"renders"| node_ascii6
node_renderer -.->|"renders"| node_ascii7
node_renderer -.->|"captures"| node_capture3
node_renderer -.->|"captures"| node_capture5
node_capture3 -->|"captures frames from"| node_p5scene3
node_capture5 -->|"captures frames from"| node_p5scene5
node_audiofeatures -->|"provides features to"| node_capture5
node_ascii -.->|"produces"| node_clips
node_ascii2 -.->|"produces"| node_clips
node_ascii4 -.->|"produces"| node_clips
node_ascii6 -.->|"produces"| node_clips
node_ascii7 -.->|"produces"| node_clips
node_capture3 -.->|"produces"| node_clips
node_capture5 -.->|"produces"| node_clips
node_clips -->|"reviews"| node_editor
node_editor -->|"analyzes media with"| node_analyzer
node_editor -->|"assembles"| node_final
node_hermes -->|"dispatches tasks to"| node_director
node_hermes -->|"dispatches tasks to"| node_cinematographer
node_hermes -->|"dispatches tasks to"| node_renderer
node_hermes -->|"dispatches tasks to"| node_editor

click node_brief "https://github.com/nousresearch/kanban-video-pipeline/blob/main/brief.md"
click node_director "https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md"
click node_cinematographer "https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md"
click node_brand "https://github.com/nousresearch/kanban-video-pipeline/blob/main/taste/brand-guide.md"
click node_emotional "https://github.com/nousresearch/kanban-video-pipeline/blob/main/taste/emotional-dna.md"
click node_renderer "https://github.com/nousresearch/kanban-video-pipeline/tree/main/render-scripts"
click node_ascii "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-01/render.py"
click node_ascii2 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-02/render.py"
click node_ascii4 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-04/render.py"
click node_ascii6 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-06/render.py"
click node_ascii7 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-07/render.py"
click node_p5scene3 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-03/sketch.html"
click node_capture3 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-03/capture.js"
click node_p5scene5 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/sketch.html"
click node_audiofeatures "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/extract_audio.py"
click node_capture5 "https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/capture.js"
click node_analyzer "https://github.com/nousresearch/kanban-video-pipeline/blob/main/tools/media_analyze.py"
click node_editor "https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md"

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_brief,node_director,node_cinematographer,node_brand,node_emotional,node_editor toneBlue
class node_renderer,node_ascii,node_ascii2,node_ascii4,node_ascii6,node_ascii7,node_p5scene3,node_capture3,node_p5scene5,node_capture5,node_clips,node_final toneAmber
class node_audiofeatures,node_analyzer toneMint
class node_creator,node_hermes toneIndigo
```

## Components

### Creative planning

- [Video brief](https://github.com/nousresearch/kanban-video-pipeline/blob/main/brief.md): `brief.md`
- [Director](https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md): `README.md`
- [Cinematographer](https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md): `README.md`
- [Brand guide](https://github.com/nousresearch/kanban-video-pipeline/blob/main/taste/brand-guide.md): `taste/brand-guide.md`
- [Emotional DNA](https://github.com/nousresearch/kanban-video-pipeline/blob/main/taste/emotional-dna.md): `taste/emotional-dna.md`
- [Editor](https://github.com/nousresearch/kanban-video-pipeline/blob/main/README.md): `README.md`

### Scene production

- [Scene renderers](https://github.com/nousresearch/kanban-video-pipeline/tree/main/render-scripts): `render-scripts`
- [ASCII scenes](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-01/render.py): `render-scripts/scene-01/render.py`
- [Additional ASCII scenes](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-02/render.py): `render-scripts/scene-02/render.py`
- [Terminal scene](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-04/render.py): `render-scripts/scene-04/render.py`
- [Completion scene](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-06/render.py): `render-scripts/scene-06/render.py`
- [Logo scene](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-07/render.py): `render-scripts/scene-07/render.py`
- [Generative scene 3](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-03/sketch.html): `render-scripts/scene-03/sketch.html`
- [Scene 3 capture](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-03/capture.js): `render-scripts/scene-03/capture.js`
- [Generative scene 5](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/sketch.html): `render-scripts/scene-05/sketch.html`
- [Scene 5 capture](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/capture.js): `render-scripts/scene-05/capture.js`
- **Rendered clips**
- **Final video**

### Media tools

- [Scene 5 audio features](https://github.com/nousresearch/kanban-video-pipeline/blob/main/render-scripts/scene-05/extract_audio.py): `render-scripts/scene-05/extract_audio.py`
- [Media analyzer](https://github.com/nousresearch/kanban-video-pipeline/blob/main/tools/media_analyze.py): `tools/media_analyze.py`

### Other components

- **Video creator**
- **Hermes Kanban**

## Connections

- Video creator → Video brief: writes (evidence: `README.md`)
- Video brief → Director: guides decomposition (evidence: `README.md`)
- Director → Cinematographer: hands off (evidence: `README.md`)
- Cinematographer → Scene renderers: specifies scenes (evidence: `README.md`)
- Brand guide → Cinematographer: guides visuals (evidence: `README.md`)
- Emotional DNA → Cinematographer: guides tone (evidence: `README.md`)
- Scene renderers → ASCII scenes: renders
- Scene renderers → Additional ASCII scenes: renders
- Scene renderers → Terminal scene: renders
- Scene renderers → Completion scene: renders
- Scene renderers → Logo scene: renders
- Scene renderers → Scene 3 capture: captures
- Scene renderers → Scene 5 capture: captures
- Scene 3 capture → Generative scene 3: captures frames from (evidence: `render-scripts/scene-03/capture.js`)
- Scene 5 capture → Generative scene 5: captures frames from (evidence: `render-scripts/scene-05/capture.js`)
- Scene 5 audio features → Scene 5 capture: provides features to (evidence: `render-scripts/scene-05/capture.js`)
- ASCII scenes → Rendered clips: produces
- Additional ASCII scenes → Rendered clips: produces
- Terminal scene → Rendered clips: produces
- Completion scene → Rendered clips: produces
- Logo scene → Rendered clips: produces
- Scene 3 capture → Rendered clips: produces
- Scene 5 capture → Rendered clips: produces
- Rendered clips → Editor: reviews (evidence: `README.md`)
- Editor → Media analyzer: analyzes media with (evidence: `README.md`)
- Editor → Final video: assembles (evidence: `README.md`)
- Hermes Kanban → Director: dispatches tasks to (evidence: `README.md`)
- Hermes Kanban → Cinematographer: dispatches tasks to (evidence: `README.md`)
- Hermes Kanban → Scene renderers: dispatches tasks to (evidence: `README.md`)
- Hermes Kanban → Editor: dispatches tasks to (evidence: `README.md`)
