# sannjaay/agentic-youtuber architecture

> Architecture diagram of the GitHub repository sannjaay/agentic-youtuber, 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/sannjaay/agentic-youtuber
- Repository: https://github.com/sannjaay/agentic-youtuber

## Overview

Agentic-Youtuber automates a YouTube Shorts workflow: a trigger starts the graph, which generates a topic and script, produces narration and visual prompts, generates images, composes a video, creates metadata, uploads the video, and logs the result. The scheduler provides a daily trigger; the logger persists upload status in SQLite. The README also documents a plugin system, but no implementation appears in the tree, so that branch is shown as unverified. Edges reflect the excerpts and README; unsampled modules are not assumed to have additional behavior.

Main entry points: [`graph.py`](https://github.com/sannjaay/agentic-youtuber/blob/main/graph.py) (Workflow Graph), [`nodes/script.py`](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/script.py) (Script Generator), [`nodes/image_gen.py`](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/image_gen.py) (Image Generator), [`nodes/topic.py`](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/topic.py) (Topic Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_scheduler["Daily Scheduler<br/>[scheduler.py]"]
  node_workflow["Workflow Graph<br/>[graph.py]"]
end

subgraph group_content["Content Generation"]
  node_topic["Topic Generator<br/>[topic.py]"]
  node_script["Script Generator<br/>[script.py]"]
  node_visual_context["Visual Prompts<br/>[visuals.py]"]
end

subgraph group_media["Media Production"]
  node_tts["Voice Synthesis<br/>[tts.py]"]
  node_image_gen["Image Generator<br/>[image_gen.py]"]
  node_video["Video Composer<br/>[video.py]"]
end

subgraph group_publishing["Publishing and Tracking"]
  node_metadata["Metadata Generator<br/>[metadata.py]"]
  node_uploader["YouTube Uploader<br/>[upload.py]"]
  node_logger["Upload Logger<br/>[logger.py]"]
end

node_creator(("Creator / Trigger"))
node_ollama(("Ollama LLM"))
node_image_service(("Image Generation Service"))
node_piper(("Piper TTS"))
node_youtube(("YouTube Data API"))
node_sqlite[("SQLite Log Store")]
node_plugin_system["Plugin System"]

node_creator -->|"starts workflow"| node_workflow
node_scheduler -->|"runs daily"| node_workflow
node_workflow -->|"dispatches"| node_topic
node_workflow -->|"dispatches"| node_script
node_workflow -->|"dispatches"| node_tts
node_workflow -->|"dispatches"| node_visual_context
node_workflow -->|"dispatches"| node_image_gen
node_workflow -->|"dispatches"| node_video
node_workflow -->|"dispatches"| node_metadata
node_workflow -->|"dispatches"| node_uploader
node_workflow -->|"dispatches"| node_logger
node_topic -->|"requests topic"| node_ollama
node_script -->|"requests script"| node_ollama
node_visual_context -->|"requests prompts"| node_ollama
node_metadata -->|"requests metadata"| node_ollama
node_image_gen -->|"requests images"| node_image_service
node_tts -->|"synthesizes voice"| node_piper
node_uploader -->|"uploads video"| node_youtube
node_logger -->|"writes status"| node_sqlite
node_workflow -.->|"supports plugins"| node_plugin_system
node_plugin_system -.->|"extends workflow"| node_script
node_plugin_system -.->|"extends workflow"| node_image_gen

click node_scheduler "https://github.com/sannjaay/agentic-youtuber/blob/main/scheduler.py"
click node_workflow "https://github.com/sannjaay/agentic-youtuber/blob/main/graph.py"
click node_topic "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/topic.py"
click node_script "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/script.py"
click node_visual_context "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/visuals.py"
click node_metadata "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/metadata.py"
click node_tts "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/tts.py"
click node_image_gen "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/image_gen.py"
click node_video "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/video.py"
click node_uploader "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/upload.py"
click node_logger "https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/logger.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_scheduler,node_workflow toneBlue
class node_topic,node_script,node_visual_context,node_sqlite toneAmber
class node_tts,node_image_gen,node_video,node_youtube toneMint
class node_metadata,node_uploader,node_logger toneRose
class node_creator,node_ollama,node_image_service,node_piper,node_plugin_system toneIndigo
```

## Components

### Orchestration

- [Daily Scheduler](https://github.com/sannjaay/agentic-youtuber/blob/main/scheduler.py): `scheduler.py`
- [Workflow Graph](https://github.com/sannjaay/agentic-youtuber/blob/main/graph.py): `graph.py`

### Content Generation

- [Topic Generator](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/topic.py): `nodes/topic.py`
- [Script Generator](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/script.py): `nodes/script.py`
- [Visual Prompts](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/visuals.py): `nodes/visuals.py`

### Media Production

- [Voice Synthesis](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/tts.py): `nodes/tts.py`
- [Image Generator](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/image_gen.py): `nodes/image_gen.py`
- [Video Composer](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/video.py): `nodes/video.py`

### Publishing and Tracking

- [Metadata Generator](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/metadata.py): `nodes/metadata.py`
- [YouTube Uploader](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/upload.py): `nodes/upload.py`
- [Upload Logger](https://github.com/sannjaay/agentic-youtuber/blob/main/nodes/logger.py): `nodes/logger.py`

### Other components

- **Creator / Trigger**
- **Ollama LLM**
- **Image Generation Service**
- **Piper TTS**
- **YouTube Data API**
- **SQLite Log Store**
- **Plugin System**

## Connections

- Creator / Trigger → Workflow Graph: starts workflow (evidence: `README.md`)
- Daily Scheduler → Workflow Graph: runs daily (evidence: `scheduler.py`)
- Workflow Graph → Topic Generator: dispatches (evidence: `graph.py`)
- Workflow Graph → Script Generator: dispatches (evidence: `graph.py`)
- Workflow Graph → Voice Synthesis: dispatches (evidence: `graph.py`)
- Workflow Graph → Visual Prompts: dispatches (evidence: `graph.py`)
- Workflow Graph → Image Generator: dispatches (evidence: `graph.py`)
- Workflow Graph → Video Composer: dispatches (evidence: `graph.py`)
- Workflow Graph → Metadata Generator: dispatches (evidence: `graph.py`)
- Workflow Graph → YouTube Uploader: dispatches (evidence: `graph.py`)
- Workflow Graph → Upload Logger: dispatches (evidence: `graph.py`)
- Topic Generator → Ollama LLM: requests topic (evidence: `nodes/topic.py`)
- Script Generator → Ollama LLM: requests script (evidence: `nodes/script.py`)
- Visual Prompts → Ollama LLM: requests prompts (evidence: `nodes/visuals.py`)
- Metadata Generator → Ollama LLM: requests metadata (evidence: `nodes/metadata.py`)
- Image Generator → Image Generation Service: requests images (evidence: `nodes/image_gen.py`)
- Voice Synthesis → Piper TTS: synthesizes voice (evidence: `nodes/tts.py`)
- YouTube Uploader → YouTube Data API: uploads video (evidence: `nodes/upload.py`)
- Upload Logger → SQLite Log Store: writes status (evidence: `nodes/logger.py`)
- Workflow Graph → Plugin System: supports plugins (evidence: `README.md`)
- Plugin System → Script Generator: extends workflow (evidence: `README.md`)
- Plugin System → Image Generator: extends workflow (evidence: `README.md`)
