# chaitanyaeswarrajeshjakki/gemini-youtube-automation architecture

> Architecture diagram of the GitHub repository chaitanyaeswarrajeshjakki/gemini-youtube-automation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation
- Repository: https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation

## Overview

This repository automates a daily lesson-to-YouTube workflow: it selects or creates a curriculum, generates lesson content, produces narrated long-form and Shorts videos with thumbnails, uploads them, and records progress. The main orchestration and uploader calls are visible in source; other production capabilities and scheduled execution are documented in the README, so those links use README evidence.

Main entry points: [`main.py`](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/main.py) (Lesson Pipeline), [`src/generator.py`](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py) (Curriculum Generation), [`src/uploader.py`](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/uploader.py) (YouTube Uploader), [`.github/workflows/main.yml`](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/.github/workflows/main.yml) (Daily Scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_pipeline["Lesson Pipeline<br/>[main.py]"]
  node_plan[("Curriculum Plan<br/>[content_plan.json]")]
end

subgraph group_content["Lesson Content"]
  node_curriculum["Curriculum Generation<br/>[generator.py]"]
  node_lesson_script["Lesson Script<br/>[generator.py]"]
end

subgraph group_production["Video Production"]
  node_narration["Narration Audio<br/>[generator.py]"]
  node_visuals["Slide Visuals<br/>[generator.py]"]
  node_video["Video Rendering<br/>[generator.py]"]
  node_music["Background Music<br/>[bg_music.mp3]"]
  node_thumbnails["Custom Thumbnails<br/>[generator.py]"]
end

subgraph group_publishing["Publishing"]
  node_uploader["YouTube Uploader<br/>[uploader.py]"]
  node_repo_update[("Progress Commit<br/>[content_plan.json]")]
end

node_scheduler(("Daily Scheduler<br/>[main.yml]"))
node_gemini{{"Gemini API"}}
node_gtts{{"gTTS"}}
node_pexels{{"Pexels Imagery"}}
node_youtube{{"YouTube Data API"}}

node_scheduler -->|"starts daily"| node_pipeline
node_pipeline -->|"reads and updates"| node_plan
node_pipeline -->|"requests curriculum"| node_curriculum
node_pipeline -->|"requests lesson"| node_lesson_script
node_curriculum -->|"generates plan"| node_gemini
node_lesson_script -->|"generates script"| node_gemini
node_pipeline -->|"creates narration"| node_narration
node_narration -->|"converts speech"| node_gtts
node_pipeline -->|"creates slides"| node_visuals
node_visuals -->|"fetches imagery"| node_pexels
node_pipeline -->|"renders both formats"| node_video
node_video -->|"mixes background music"| node_music
node_pipeline -->|"creates thumbnails"| node_thumbnails
node_pipeline -->|"uploads videos"| node_uploader
node_uploader -->|"uploads video and thumbnail"| node_youtube
node_pipeline -->|"commits progress"| node_repo_update

click node_scheduler "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/.github/workflows/main.yml"
click node_pipeline "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/main.py"
click node_plan "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/content_plan.json"
click node_curriculum "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py"
click node_lesson_script "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py"
click node_narration "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py"
click node_visuals "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py"
click node_video "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py"
click node_music "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/assets/music/bg_music.mp3"
click node_thumbnails "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py"
click node_uploader "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/uploader.py"
click node_repo_update "https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/content_plan.json"

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_pipeline,node_plan toneBlue
class node_curriculum,node_lesson_script toneAmber
class node_narration,node_visuals,node_video,node_music,node_thumbnails,node_gemini,node_youtube toneMint
class node_uploader,node_repo_update,node_scheduler toneRose
class node_gtts,node_pexels toneIndigo
```

## Components

### Orchestration

- [Lesson Pipeline](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/main.py): `main.py`
- [Curriculum Plan](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/content_plan.json): `content_plan.json`

### Lesson Content

- [Curriculum Generation](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py): `src/generator.py`
- [Lesson Script](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py): `src/generator.py`

### Video Production

- [Narration Audio](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py): `src/generator.py`
- [Slide Visuals](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py): `src/generator.py`
- [Video Rendering](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py): `src/generator.py`
- [Background Music](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/assets/music/bg_music.mp3): `assets/music/bg_music.mp3`
- [Custom Thumbnails](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/generator.py): `src/generator.py`

### Publishing

- [YouTube Uploader](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/src/uploader.py): `src/uploader.py`
- [Progress Commit](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/content_plan.json): `content_plan.json`

### Other components

- [Daily Scheduler](https://github.com/chaitanyaeswarrajeshjakki/gemini-youtube-automation/blob/main/.github/workflows/main.yml): `.github/workflows/main.yml`
- **Gemini API**
- **gTTS**
- **Pexels Imagery**
- **YouTube Data API**

## Connections

- Daily Scheduler → Lesson Pipeline: starts daily (evidence: `README.md`)
- Lesson Pipeline → Curriculum Plan: reads and updates (evidence: `main.py`)
- Lesson Pipeline → Curriculum Generation: requests curriculum (evidence: `main.py`)
- Lesson Pipeline → Lesson Script: requests lesson (evidence: `main.py`)
- Curriculum Generation → Gemini API: generates plan (evidence: `README.md`)
- Lesson Script → Gemini API: generates script (evidence: `README.md`)
- Lesson Pipeline → Narration Audio: creates narration (evidence: `main.py`)
- Narration Audio → gTTS: converts speech (evidence: `README.md`)
- Lesson Pipeline → Slide Visuals: creates slides (evidence: `main.py`)
- Slide Visuals → Pexels Imagery: fetches imagery (evidence: `src/generator.py`)
- Lesson Pipeline → Video Rendering: renders both formats (evidence: `main.py`)
- Video Rendering → Background Music: mixes background music (evidence: `README.md`)
- Lesson Pipeline → Custom Thumbnails: creates thumbnails (evidence: `main.py`)
- Lesson Pipeline → YouTube Uploader: uploads videos (evidence: `main.py`)
- YouTube Uploader → YouTube Data API: uploads video and thumbnail (evidence: `src/uploader.py`)
- Lesson Pipeline → Progress Commit: commits progress (evidence: `README.md`)
