# khanh02-vin/local-first-ai-video-studio architecture

> Architecture diagram of the GitHub repository khanh02-vin/local-first-ai-video-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/khanh02-vin/local-first-ai-video-studio
- Repository: https://github.com/khanh02-vin/local-first-ai-video-studio

## Overview

This is a local-first video editing and repurposing product, with a desktop application and web interface. The main workflow is to analyze source media into transcripts and highlights, turn selected material into an editable render plan, and render a finished clip. Other documented-by-code capabilities include diarization, YouTube discovery and a local RAG knowledge base, project persistence, and publishing interfaces. The graph follows evidenced calls and imports; many desktop commands and several major subsystems are indexed but unsampled, so their internal links are intentionally limited.

Main entry points: [`apps/web/src/lib/pages/Studio.svelte`](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/web/src/lib/pages/Studio.svelte) (Web studio), [`apps/desktop/src-tauri/src/main.rs`](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/main.rs) (Desktop app), [`services/ai-pipeline/index.ts`](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/index.ts) (Analysis pipeline), [`services/ai-pipeline/variants.ts`](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/variants.ts) (Edit variants)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interfaces"]
  node_web["Web studio<br/>[Studio.svelte]"]
  node_desktop["Desktop app<br/>[main.rs]"]
end

subgraph group_analysis["Media analysis"]
  node_pipeline["Analysis pipeline<br/>[index.ts]"]
  node_transcribe["Whisper transcription<br/>[chunked-whisper.ts]"]
  node_diarize["Speaker diarization<br/>[diarization.ts]"]
  node_semantic["Semantic highlights<br/>[semantic.ts]"]
  node_variants["Edit variants<br/>[variants.ts]"]
end

subgraph group_editing["Editing and rendering"]
  node_editorcore["Editor state<br/>[index.ts]"]
  node_renderer["FFmpeg renderer<br/>[engine.rs]"]
end

subgraph group_state["Projects and contracts"]
  node_transcript["Transcript contract<br/>[transcript.ts]"]
  node_highlight["Highlight contract<br/>[highlight.ts]"]
  node_renderplan["Render plan contract<br/>[render-plan.ts]"]
  node_projects[("Project persistence<br/>[project_store.rs]")]
  node_analysisstore[("Analysis storage<br/>[analysis_store.rs]")]
end

subgraph group_discovery["YouTube and publishing"]
  node_youtube["YouTube discovery<br/>[youtube.rs]"]
  node_rag["Local video knowledge<br/>[+server.ts]"]
  node_ranking["Related video ranking<br/>[index.ts]"]
  node_publishing["Publishing integration<br/>[index.ts]"]
end

node_creator(("Creator"))
node_platforms(("Video platforms"))

node_creator -->|"uses"| node_web
node_creator -.->|"uses"| node_desktop
node_web -->|"runs analysis"| node_pipeline
node_pipeline -->|"transcribes"| node_transcribe
node_pipeline -->|"selects highlights"| node_semantic
node_pipeline -->|"validates"| node_transcript
node_pipeline -->|"validates"| node_highlight
node_diarize -->|"uses contract"| node_transcript
node_variants -->|"uses contract"| node_transcript
node_variants -->|"produces plan"| node_renderplan
node_web -->|"uses"| node_diarize
node_web -->|"uses"| node_variants
node_web -->|"edits clips"| node_editorcore
node_editorcore -->|"validates"| node_renderplan
node_desktop -.->|"renders media"| node_renderer
node_desktop -->|"loads and saves"| node_projects
node_desktop -.->|"coordinates analysis"| node_analysisstore
node_desktop -.->|"provides discovery"| node_youtube
node_web -.->|"queries knowledge"| node_rag
node_rag -->|"ranks candidates"| node_ranking
node_creator -.->|"publishes"| node_publishing
node_publishing -.->|"connects accounts"| node_platforms

click node_web "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/web/src/lib/pages/Studio.svelte"
click node_desktop "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/main.rs"
click node_pipeline "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/index.ts"
click node_transcribe "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/adapters/local/chunked-whisper.ts"
click node_diarize "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/diarization.ts"
click node_semantic "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/semantic.ts"
click node_variants "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/variants.ts"
click node_transcript "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/contracts/transcript.ts"
click node_highlight "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/contracts/highlight.ts"
click node_renderplan "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/contracts/render-plan.ts"
click node_editorcore "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/editor-core/index.ts"
click node_renderer "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/crates/render-engine/src/engine.rs"
click node_projects "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/project_store.rs"
click node_analysisstore "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/analysis_store.rs"
click node_youtube "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/youtube.rs"
click node_rag "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/web/src/routes/api/rag/%2Bserver.ts"
click node_ranking "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/media-engine/related-videos/index.ts"
click node_publishing "https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/publishing/index.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_web,node_desktop toneBlue
class node_pipeline,node_transcribe,node_diarize,node_semantic,node_variants toneAmber
class node_editorcore,node_renderer toneMint
class node_transcript,node_highlight,node_renderplan,node_projects,node_analysisstore toneRose
class node_youtube,node_rag,node_ranking,node_publishing,node_creator,node_platforms toneIndigo
```

## Components

### User interfaces

- [Web studio](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/web/src/lib/pages/Studio.svelte): `apps/web/src/lib/pages/Studio.svelte`
- [Desktop app](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/main.rs): `apps/desktop/src-tauri/src/main.rs`

### Media analysis

- [Analysis pipeline](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/index.ts): `services/ai-pipeline/index.ts`
- [Whisper transcription](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/adapters/local/chunked-whisper.ts): `adapters/local/chunked-whisper.ts`
- [Speaker diarization](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/diarization.ts): `services/ai-pipeline/diarization.ts`
- [Semantic highlights](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/semantic.ts): `services/ai-pipeline/semantic.ts`
- [Edit variants](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/ai-pipeline/variants.ts): `services/ai-pipeline/variants.ts`

### Editing and rendering

- [Editor state](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/editor-core/index.ts): `packages/editor-core/index.ts`
- [FFmpeg renderer](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/crates/render-engine/src/engine.rs): `apps/desktop/src-tauri/crates/render-engine/src/engine.rs`

### Projects and contracts

- [Transcript contract](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/contracts/transcript.ts): `packages/contracts/transcript.ts`
- [Highlight contract](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/contracts/highlight.ts): `packages/contracts/highlight.ts`
- [Render plan contract](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/contracts/render-plan.ts): `packages/contracts/render-plan.ts`
- [Project persistence](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/project_store.rs): `apps/desktop/src-tauri/src/project_store.rs`
- [Analysis storage](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/analysis_store.rs): `apps/desktop/src-tauri/src/analysis_store.rs`

### YouTube and publishing

- [YouTube discovery](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/desktop/src-tauri/src/youtube.rs): `apps/desktop/src-tauri/src/youtube.rs`
- [Local video knowledge](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/apps/web/src/routes/api/rag/%2Bserver.ts): `apps/web/src/routes/api/rag/+server.ts`
- [Related video ranking](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/packages/media-engine/related-videos/index.ts): `packages/media-engine/related-videos/index.ts`
- [Publishing integration](https://github.com/khanh02-vin/local-first-ai-video-studio/blob/main/services/publishing/index.ts): `services/publishing/index.ts`

### Other components

- **Creator**
- **Video platforms**

## Connections

- Creator → Web studio: uses (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Creator → Desktop app: uses
- Web studio → Analysis pipeline: runs analysis (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Analysis pipeline → Whisper transcription: transcribes (evidence: `services/ai-pipeline/index.ts`)
- Analysis pipeline → Semantic highlights: selects highlights (evidence: `services/ai-pipeline/index.ts`)
- Analysis pipeline → Transcript contract: validates (evidence: `services/ai-pipeline/index.ts`)
- Analysis pipeline → Highlight contract: validates (evidence: `services/ai-pipeline/index.ts`)
- Speaker diarization → Transcript contract: uses contract (evidence: `services/ai-pipeline/diarization.ts`)
- Edit variants → Transcript contract: uses contract (evidence: `services/ai-pipeline/variants.ts`)
- Edit variants → Render plan contract: produces plan (evidence: `services/ai-pipeline/variants.ts`)
- Web studio → Speaker diarization: uses (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Web studio → Edit variants: uses (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Web studio → Editor state: edits clips (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Editor state → Render plan contract: validates (evidence: `packages/editor-core/index.ts`)
- Desktop app → FFmpeg renderer: renders media
- Desktop app → Project persistence: loads and saves (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Desktop app → Analysis storage: coordinates analysis (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Desktop app → YouTube discovery: provides discovery (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Web studio → Local video knowledge: queries knowledge
- Local video knowledge → Related video ranking: ranks candidates (evidence: `apps/web/src/routes/api/rag/+server.ts`)
- Creator → Publishing integration: publishes
- Publishing integration → Video platforms: connects accounts
