# gnaro-shaft/tiktok-generator-video architecture

> Architecture diagram of the GitHub repository gnaro-shaft/tiktok-generator-video, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gnaro-shaft/tiktok-generator-video
- Repository: https://github.com/gnaro-shaft/tiktok-generator-video

## Overview

This repository generates short-form TikTok videos across six configured niches. The main workflow starts from a CLI request, loads niche settings and prompts, generates a script, then synthesizes narration and finds stock footage before rendering a Remotion overlay and composing the final video; optional music mixing and run-history tracking support that process. Separate core modules provide TikTok authorization, publishing, and analytics. README and sampled pipeline code establish the generation stages; unsampled TikTok modules are retained as capabilities, but their runtime wiring to the CLI is not asserted.

Main entry points: [`packages/core/src/lib/pipeline.ts`](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/pipeline.ts) (Generation pipeline), [`apps/cli/src/main.ts`](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/apps/cli/src/main.ts) (Generation CLI), [`packages/core/src/lib/render.ts`](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/render.ts) (Overlay rendering), [`packages/core/src/lib/compose.ts`](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/compose.ts) (Video composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry &amp; Configuration"]
  node_cli["Generation CLI<br/>[main.ts]"]
  node_niche["Niche settings"]
  node_config["Config loader<br/>[config.ts]"]
end

subgraph group_generation["Content Generation"]
  node_pipeline["Generation pipeline<br/>[pipeline.ts]"]
  node_script["Script generation<br/>[script.ts]"]
  node_voice["Voice synthesis<br/>[voice.ts]"]
  node_stock["Stock footage<br/>[stock.ts]"]
  node_history[("Run history<br/>[state.ts]")]
end

subgraph group_video["Video Production"]
  node_music["Music mixing<br/>[music.ts]"]
  node_render["Overlay rendering<br/>[render.ts]"]
  node_remotion["Remotion compositions<br/>[TikTokVideo.tsx]"]
  node_slides["Slides composition<br/>[SlidesVideo.tsx]"]
  node_compose["Video composition<br/>[compose.ts]"]
end

subgraph group_tiktok["TikTok Integration"]
  node_tiktokauth["TikTok OAuth<br/>[tiktok-auth.ts]"]
  node_publish["TikTok publishing<br/>[tiktok-publish.ts]"]
  node_analytics["TikTok analytics"]
end

node_creator(("CLI user"))
node_anthropic{{"Anthropic API"}}
node_elevenlabs{{"ElevenLabs API"}}
node_stockapis{{"Pexels / Pixabay"}}
node_ffmpeg{{"ffmpeg"}}
node_output["Video &amp; sidecars"]
node_tiktok{{"TikTok API"}}

node_creator -->|"requests generation"| node_cli
node_cli -->|"loads settings"| node_config
node_config -->|"loads niche"| node_niche
node_cli -->|"starts run"| node_pipeline
node_pipeline -->|"generates script"| node_script
node_script -->|"requests completion"| node_anthropic
node_pipeline -->|"synthesizes narration"| node_voice
node_voice -->|"requests speech"| node_elevenlabs
node_pipeline -->|"searches footage"| node_stock
node_stock -->|"searches providers"| node_stockapis
node_pipeline -->|"mixes audio"| node_music
node_pipeline -->|"renders overlay"| node_render
node_render -->|"renders composition"| node_remotion
node_render -->|"renders slides"| node_slides
node_pipeline -->|"composes video"| node_compose
node_compose -->|"runs composition"| node_ffmpeg
node_pipeline -->|"records run"| node_history
node_compose -->|"writes video"| node_output
node_pipeline -->|"writes sidecars"| node_output
node_publish -->|"uses authorization"| node_tiktokauth
node_analytics -->|"uses authorization"| node_tiktokauth
node_tiktokauth -->|"exchanges tokens"| node_tiktok
node_publish -.->|"publishes videos"| node_tiktok
node_analytics -.->|"fetches metrics"| node_tiktok

click node_cli "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/apps/cli/src/main.ts"
click node_niche "https://github.com/gnaro-shaft/tiktok-generator-video/tree/main/niches"
click node_config "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/config.ts"
click node_pipeline "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/pipeline.ts"
click node_script "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/script.ts"
click node_voice "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/voice.ts"
click node_stock "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/stock.ts"
click node_music "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/music.ts"
click node_render "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/render.ts"
click node_remotion "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/remotion/src/TikTokVideo.tsx"
click node_slides "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/remotion/src/SlidesVideo.tsx"
click node_compose "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/compose.ts"
click node_history "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/state.ts"
click node_tiktokauth "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/tiktok-auth.ts"
click node_publish "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/tiktok-publish.ts"
click node_analytics "https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/tiktok-analytics.ts"

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_cli,node_niche,node_config,node_creator toneBlue
class node_pipeline,node_script,node_voice,node_stock,node_history toneAmber
class node_music,node_render,node_remotion,node_slides,node_compose,node_anthropic,node_elevenlabs,node_tiktok toneMint
class node_tiktokauth,node_publish,node_analytics toneRose
class node_stockapis,node_ffmpeg,node_output toneIndigo
```

## Components

### Entry & Configuration

- [Generation CLI](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/apps/cli/src/main.ts): `apps/cli/src/main.ts`
- [Niche settings](https://github.com/gnaro-shaft/tiktok-generator-video/tree/main/niches): `niches`
- [Config loader](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/config.ts): `packages/core/src/lib/config.ts`

### Content Generation

- [Generation pipeline](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/pipeline.ts): `packages/core/src/lib/pipeline.ts`
- [Script generation](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/script.ts): `packages/core/src/lib/script.ts`
- [Voice synthesis](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/voice.ts): `packages/core/src/lib/voice.ts`
- [Stock footage](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/stock.ts): `packages/core/src/lib/stock.ts`
- [Run history](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/state.ts): `packages/core/src/lib/state.ts`

### Video Production

- [Music mixing](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/music.ts): `packages/core/src/lib/music.ts`
- [Overlay rendering](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/render.ts): `packages/core/src/lib/render.ts`
- [Remotion compositions](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/remotion/src/TikTokVideo.tsx): `packages/remotion/src/TikTokVideo.tsx`
- [Slides composition](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/remotion/src/SlidesVideo.tsx): `packages/remotion/src/SlidesVideo.tsx`
- [Video composition](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/compose.ts): `packages/core/src/lib/compose.ts`

### TikTok Integration

- [TikTok OAuth](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/tiktok-auth.ts): `packages/core/src/lib/tiktok-auth.ts`
- [TikTok publishing](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/tiktok-publish.ts): `packages/core/src/lib/tiktok-publish.ts`
- [TikTok analytics](https://github.com/gnaro-shaft/tiktok-generator-video/blob/main/packages/core/src/lib/tiktok-analytics.ts): `packages/core/src/lib/tiktok-analytics.ts`

### Other components

- **CLI user**
- **Anthropic API**
- **ElevenLabs API**
- **Pexels / Pixabay**
- **ffmpeg**
- **Video & sidecars**
- **TikTok API**

## Connections

- CLI user → Generation CLI: requests generation (evidence: `README.md`)
- Generation CLI → Config loader: loads settings (evidence: `apps/cli/src/main.ts`)
- Config loader → Niche settings: loads niche (evidence: `packages/core/src/lib/config.ts`)
- Generation CLI → Generation pipeline: starts run (evidence: `apps/cli/src/main.ts`)
- Generation pipeline → Script generation: generates script (evidence: `packages/core/src/lib/pipeline.ts`)
- Script generation → Anthropic API: requests completion (evidence: `packages/core/src/lib/script.ts`)
- Generation pipeline → Voice synthesis: synthesizes narration (evidence: `packages/core/src/lib/pipeline.ts`)
- Voice synthesis → ElevenLabs API: requests speech (evidence: `packages/core/src/lib/voice.ts`)
- Generation pipeline → Stock footage: searches footage (evidence: `packages/core/src/lib/pipeline.ts`)
- Stock footage → Pexels / Pixabay: searches providers (evidence: `packages/core/src/lib/stock.ts`)
- Generation pipeline → Music mixing: mixes audio (evidence: `packages/core/src/lib/pipeline.ts`)
- Generation pipeline → Overlay rendering: renders overlay (evidence: `packages/core/src/lib/pipeline.ts`)
- Overlay rendering → Remotion compositions: renders composition (evidence: `README.md`)
- Overlay rendering → Slides composition: renders slides (evidence: `README.md`)
- Generation pipeline → Video composition: composes video (evidence: `README.md`)
- Video composition → ffmpeg: runs composition (evidence: `packages/core/src/lib/compose.ts`)
- Generation pipeline → Run history: records run (evidence: `packages/core/src/lib/pipeline.ts`)
- Video composition → Video & sidecars: writes video (evidence: `README.md`)
- Generation pipeline → Video & sidecars: writes sidecars (evidence: `README.md`)
- TikTok publishing → TikTok OAuth: uses authorization (evidence: `packages/core/src/lib/tiktok-publish.ts`)
- TikTok analytics → TikTok OAuth: uses authorization (evidence: `packages/core/src/lib/tiktok-analytics.ts`)
- TikTok OAuth → TikTok API: exchanges tokens (evidence: `packages/core/src/lib/tiktok-auth.ts`)
- TikTok publishing → TikTok API: publishes videos
- TikTok analytics → TikTok API: fetches metrics
