# saiedpod-bot/stickman-studio architecture

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

- Interactive diagram: https://gitdiagram.com/saiedpod-bot/stickman-studio
- Repository: https://github.com/saiedpod-bot/stickman-studio

## Overview

Stickman Studio is an AI video-production application with CLI and Streamlit entry points. Its main workflow turns a topic into a storyboard, generated scene imagery, slideshow or Veo clips, narration and an assembled video; users can then preview, download or publish it. Separate capabilities plan content and schedule recurring production. The graph follows documented stages and indexed references; several phase-to-phase calls and dashboard internals were not excerpted, so those links rely on README descriptions or are omitted.

Main entry points: [`ai_engine.py`](https://github.com/saiedpod-bot/stickman-studio/blob/main/ai_engine.py) (AI engine), [`orchestrator.py`](https://github.com/saiedpod-bot/stickman-studio/blob/main/orchestrator.py) (Pipeline runner), [`app.py`](https://github.com/saiedpod-bot/stickman-studio/blob/main/app.py) (Dashboard), [`stickman_studio/phases/phase4_assembly.py`](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase4_assembly.py) (Video assembly)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_dashboard["Dashboard<br/>[app.py]"]
  node_cli["Pipeline CLI<br/>[orchestrator.py]"]
end

subgraph group_planning["Planning and control"]
  node_planner["Content planner<br/>[content_planner.py]"]
  node_scheduler["Scheduler<br/>[scheduler.py]"]
  node_orchestrator["Pipeline runner<br/>[orchestrator.py]"]
end

subgraph group_production["Video production"]
  node_storyboard["Storyboard model<br/>[models.py]"]
  node_script["Scriptwriting<br/>[phase1_script.py]"]
  node_images["Scene images<br/>[phase2_images.py]"]
  node_slideshow["Slideshow video"]
  node_veo["Veo clips<br/>[phase3_video.py]"]
  node_subtitles["Subtitles"]
  node_assembly["Video assembly<br/>[phase4_assembly.py]"]
end

subgraph group_services["AI and media services"]
  node_ai["AI engine<br/>[ai_engine.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_retry["Retry policy<br/>[retry.py]"]
  node_tts["Speech synthesis<br/>[tts_engine.py]"]
  node_storage[("Cloud storage<br/>[storage.py]")]
end

subgraph group_delivery["Publishing and scheduling"]
  node_youtube["YouTube uploader<br/>[uploader.py]"]
  node_youtube_service(("YouTube"))
  node_assets[("Generated project")]
end

node_user(("Creator"))

node_user -->|"uses"| node_dashboard
node_user -->|"runs"| node_cli
node_dashboard -->|"starts generation"| node_orchestrator
node_dashboard -->|"requests ideas"| node_planner
node_dashboard -->|"manages schedule"| node_scheduler
node_dashboard -->|"publishes video"| node_youtube
node_cli -->|"runs pipeline"| node_orchestrator
node_scheduler -->|"gets plan"| node_planner
node_scheduler -->|"runs production"| node_orchestrator
node_scheduler -->|"uploads video"| node_youtube
node_orchestrator -->|"requests generation"| node_ai
node_orchestrator -->|"generates narration"| node_tts
node_orchestrator -->|"uses storage"| node_storage
node_orchestrator -->|"loads and saves"| node_storyboard
node_ai -->|"delegates"| node_script
node_ai -->|"delegates"| node_images
node_ai -->|"delegates"| node_slideshow
node_ai -->|"delegates"| node_veo
node_ai -->|"delegates"| node_subtitles
node_ai -->|"delegates"| node_assembly
node_orchestrator -->|"uploads final"| node_youtube
node_youtube -->|"uploads video"| node_youtube_service
node_orchestrator -->|"writes project"| node_assets
node_planner -.->|"generates ideas"| node_ai
node_config -.->|"configures models"| node_ai
node_retry -.->|"wraps calls"| node_ai
node_slideshow -.->|"assembles output"| node_assembly
node_veo -.->|"assembles output"| node_assembly
node_tts -.->|"provides audio"| node_assembly
node_subtitles -.->|"adds captions"| node_assembly

click node_dashboard "https://github.com/saiedpod-bot/stickman-studio/blob/main/app.py"
click node_cli "https://github.com/saiedpod-bot/stickman-studio/blob/main/orchestrator.py"
click node_planner "https://github.com/saiedpod-bot/stickman-studio/blob/main/content_planner.py"
click node_scheduler "https://github.com/saiedpod-bot/stickman-studio/blob/main/scheduler.py"
click node_orchestrator "https://github.com/saiedpod-bot/stickman-studio/blob/main/orchestrator.py"
click node_storyboard "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/models.py"
click node_script "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase1_script.py"
click node_images "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase2_images.py"
click node_slideshow "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase3_slideshow.py"
click node_veo "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase3_video.py"
click node_subtitles "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase4_subtitles.py"
click node_assembly "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase4_assembly.py"
click node_ai "https://github.com/saiedpod-bot/stickman-studio/blob/main/ai_engine.py"
click node_config "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/config.py"
click node_retry "https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/retry.py"
click node_tts "https://github.com/saiedpod-bot/stickman-studio/blob/main/tts_engine.py"
click node_storage "https://github.com/saiedpod-bot/stickman-studio/blob/main/storage.py"
click node_youtube "https://github.com/saiedpod-bot/stickman-studio/blob/main/uploader.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,node_cli toneBlue
class node_planner,node_scheduler,node_orchestrator toneAmber
class node_storyboard,node_script,node_images,node_slideshow,node_veo,node_subtitles,node_assembly toneMint
class node_ai,node_config,node_retry,node_tts,node_storage toneRose
class node_youtube,node_youtube_service,node_assets,node_user toneIndigo
```

## Components

### User interfaces

- [Dashboard](https://github.com/saiedpod-bot/stickman-studio/blob/main/app.py): `app.py`
- [Pipeline CLI](https://github.com/saiedpod-bot/stickman-studio/blob/main/orchestrator.py): `orchestrator.py`

### Planning and control

- [Content planner](https://github.com/saiedpod-bot/stickman-studio/blob/main/content_planner.py): `content_planner.py`
- [Scheduler](https://github.com/saiedpod-bot/stickman-studio/blob/main/scheduler.py): `scheduler.py`
- [Pipeline runner](https://github.com/saiedpod-bot/stickman-studio/blob/main/orchestrator.py): `orchestrator.py`

### Video production

- [Storyboard model](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/models.py): `stickman_studio/models.py`
- [Scriptwriting](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase1_script.py): `stickman_studio/phases/phase1_script.py`
- [Scene images](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase2_images.py): `stickman_studio/phases/phase2_images.py`
- [Slideshow video](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase3_slideshow.py): `stickman_studio/phases/phase3_slideshow.py`
- [Veo clips](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase3_video.py): `stickman_studio/phases/phase3_video.py`
- [Subtitles](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase4_subtitles.py): `stickman_studio/phases/phase4_subtitles.py`
- [Video assembly](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/phases/phase4_assembly.py): `stickman_studio/phases/phase4_assembly.py`

### AI and media services

- [AI engine](https://github.com/saiedpod-bot/stickman-studio/blob/main/ai_engine.py): `ai_engine.py`
- [Configuration](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/config.py): `stickman_studio/config.py`
- [Retry policy](https://github.com/saiedpod-bot/stickman-studio/blob/main/stickman_studio/retry.py): `stickman_studio/retry.py`
- [Speech synthesis](https://github.com/saiedpod-bot/stickman-studio/blob/main/tts_engine.py): `tts_engine.py`
- [Cloud storage](https://github.com/saiedpod-bot/stickman-studio/blob/main/storage.py): `storage.py`

### Publishing and scheduling

- [YouTube uploader](https://github.com/saiedpod-bot/stickman-studio/blob/main/uploader.py): `uploader.py`
- **YouTube**
- **Generated project**

### Other components

- **Creator**

## Connections

- Creator → Dashboard: uses (evidence: `README.md`)
- Creator → Pipeline CLI: runs (evidence: `README.md`)
- Dashboard → Pipeline runner: starts generation (evidence: `app.py`)
- Dashboard → Content planner: requests ideas (evidence: `app.py`)
- Dashboard → Scheduler: manages schedule (evidence: `app.py`)
- Dashboard → YouTube uploader: publishes video (evidence: `app.py`)
- Pipeline CLI → Pipeline runner: runs pipeline (evidence: `orchestrator.py`)
- Scheduler → Content planner: gets plan (evidence: `scheduler.py`)
- Scheduler → Pipeline runner: runs production (evidence: `scheduler.py`)
- Scheduler → YouTube uploader: uploads video (evidence: `scheduler.py`)
- Pipeline runner → AI engine: requests generation (evidence: `orchestrator.py`)
- Pipeline runner → Speech synthesis: generates narration (evidence: `orchestrator.py`)
- Pipeline runner → Cloud storage: uses storage (evidence: `orchestrator.py`)
- Pipeline runner → Storyboard model: loads and saves (evidence: `orchestrator.py`)
- AI engine → Scriptwriting: delegates (evidence: `ai_engine.py`)
- AI engine → Scene images: delegates (evidence: `ai_engine.py`)
- AI engine → Slideshow video: delegates (evidence: `ai_engine.py`)
- AI engine → Veo clips: delegates (evidence: `ai_engine.py`)
- AI engine → Subtitles: delegates (evidence: `ai_engine.py`)
- AI engine → Video assembly: delegates (evidence: `ai_engine.py`)
- Pipeline runner → YouTube uploader: uploads final (evidence: `orchestrator.py`)
- YouTube uploader → YouTube: uploads video (evidence: `uploader.py`)
- Pipeline runner → Generated project: writes project (evidence: `README.md`)
- Content planner → AI engine: generates ideas
- Configuration → AI engine: configures models (evidence: `ai_engine.py`)
- Retry policy → AI engine: wraps calls
- Slideshow video → Video assembly: assembles output
- Veo clips → Video assembly: assembles output
- Speech synthesis → Video assembly: provides audio
- Subtitles → Video assembly: adds captions
