# khanh02-vin/alts architecture

> Architecture diagram of the GitHub repository khanh02-vin/alts, 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/alts
- Repository: https://github.com/khanh02-vin/alts

## Overview

Local-first AI Video Studio turns imported media into an edited vertical MP4, with the desktop app as its primary workflow: manage a project, analyze/transcribe locally, review highlights, edit a render plan, and render. The README also documents link-based imports, speaker/diarization and face-aware reframing, provider settings, and a RAG sidecar. The graph preserves those product branches; edges are limited to README statements and source-index references or shown calls, so some unsampled command wiring is omitted.

Main entry points: [`services/ai-pipeline/index.ts`](https://github.com/khanh02-vin/alts/blob/main/services/ai-pipeline/index.ts) (Analysis orchestration), [`apps/web/src/lib/pages/Studio.svelte`](https://github.com/khanh02-vin/alts/blob/main/apps/web/src/lib/pages/Studio.svelte) (Studio UI), [`apps/desktop/src-tauri/src/main.rs`](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/main.rs) (Tauri commands), [`apps/desktop/src-tauri/crates/render-engine/src/engine.rs`](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/crates/render-engine/src/engine.rs) (FFmpeg renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop workflow"]
  node_ui["Studio UI<br/>[Studio.svelte]"]
  node_commands["Tauri commands<br/>[main.rs]"]
  node_projects[("Project storage<br/>[project_store.rs]")]
  node_runtime["Runtime services<br/>[runtime.rs]"]
  node_media["Media import and probe<br/>[youtube.rs]"]
end

subgraph group_analysis["Analysis and AI"]
  node_analysis["Analysis orchestration<br/>[index.ts]"]
  node_stt["Whisper transcription<br/>[chunked-whisper.ts]"]
  node_transcript["Transcript contracts<br/>[transcript.ts]"]
  node_highlights["Highlight selection"]
  node_diarization["Speaker diarization<br/>[diarization.rs]"]
  node_providers["AI providers<br/>[providers.rs]"]
  node_contracts["Highlight contracts<br/>[highlight.ts]"]
end

subgraph group_editing["Editing and rendering"]
  node_editor["Render-plan editing<br/>[index.ts]"]
  node_plan["Render-plan contract<br/>[render-plan.ts]"]
  node_render["Render commands<br/>[render.rs]"]
  node_engine["FFmpeg renderer<br/>[engine.rs]"]
  node_mediaengine["Probe and reframe<br/>[index.ts]"]
end

subgraph group_web["Web and discovery"]
  node_rag["RAG sidecar<br/>[+server.ts]"]
  node_related["Related video search<br/>[index.ts]"]
  node_ragdata[("RAG document store<br/>[+server.ts]")]
end

node_user(("Creator"))
node_ffmpeg["FFmpeg"]
node_youtube(("Video platforms"))
node_state[("Local filesystem and SQLite")]

node_user -->|"imports and edits"| node_ui
node_ui -->|"invokes"| node_commands
node_commands -->|"manages projects"| node_projects
node_projects -->|"reads and writes"| node_state
node_commands -.->|"dispatches analysis"| node_runtime
node_commands -.->|"dispatches import"| node_media
node_media -->|"fetches link media"| node_youtube
node_runtime -.->|"runs analysis"| node_analysis
node_analysis -->|"transcribes audio"| node_stt
node_stt -->|"produces transcript"| node_transcript
node_analysis -->|"selects highlights"| node_highlights
node_analysis -->|"validates highlights"| node_contracts
node_analysis -.->|"adds speakers"| node_diarization
node_analysis -.->|"uses configured models"| node_providers
node_ui -->|"edits selected cuts"| node_editor
node_editor -->|"validates plan"| node_plan
node_commands -.->|"dispatches render"| node_render
node_render -->|"renders plan"| node_engine
node_engine -->|"encodes video"| node_ffmpeg
node_engine -->|"writes MP4"| node_state
node_ui -.->|"uses media tools"| node_mediaengine
node_ui -->|"searches related videos"| node_related
node_related -.->|"queries videos"| node_youtube
node_rag -->|"reads and writes"| node_ragdata
node_rag -.->|"supports discovery"| node_related

click node_ui "https://github.com/khanh02-vin/alts/blob/main/apps/web/src/lib/pages/Studio.svelte"
click node_commands "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/main.rs"
click node_projects "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/project_store.rs"
click node_runtime "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/runtime.rs"
click node_media "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/youtube.rs"
click node_analysis "https://github.com/khanh02-vin/alts/blob/main/services/ai-pipeline/index.ts"
click node_stt "https://github.com/khanh02-vin/alts/blob/main/adapters/local/chunked-whisper.ts"
click node_transcript "https://github.com/khanh02-vin/alts/blob/main/packages/contracts/transcript.ts"
click node_highlights "https://github.com/khanh02-vin/alts/blob/main/services/ai-pipeline/highlight-scoring.ts"
click node_diarization "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/diarization.rs"
click node_providers "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/providers.rs"
click node_contracts "https://github.com/khanh02-vin/alts/blob/main/packages/contracts/highlight.ts"
click node_editor "https://github.com/khanh02-vin/alts/blob/main/packages/editor-core/index.ts"
click node_plan "https://github.com/khanh02-vin/alts/blob/main/packages/contracts/render-plan.ts"
click node_render "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/render.rs"
click node_engine "https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/crates/render-engine/src/engine.rs"
click node_rag "https://github.com/khanh02-vin/alts/blob/main/apps/web/src/routes/api/rag/%2Bserver.ts"
click node_related "https://github.com/khanh02-vin/alts/blob/main/packages/media-engine/related-videos/index.ts"
click node_mediaengine "https://github.com/khanh02-vin/alts/blob/main/packages/media-engine/reframe/index.ts"
click node_ragdata "https://github.com/khanh02-vin/alts/blob/main/apps/web/src/routes/api/rag/%2Bserver.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_ui,node_commands,node_projects,node_runtime,node_media toneBlue
class node_analysis,node_stt,node_transcript,node_highlights,node_diarization,node_providers,node_contracts,node_state toneAmber
class node_editor,node_plan,node_render,node_engine,node_mediaengine toneMint
class node_rag,node_related,node_ragdata toneRose
class node_user,node_ffmpeg,node_youtube toneIndigo
```

## Components

### Desktop workflow

- [Studio UI](https://github.com/khanh02-vin/alts/blob/main/apps/web/src/lib/pages/Studio.svelte): `apps/web/src/lib/pages/Studio.svelte`
- [Tauri commands](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/main.rs): `apps/desktop/src-tauri/src/main.rs`
- [Project storage](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/project_store.rs): `apps/desktop/src-tauri/src/project_store.rs`
- [Runtime services](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/runtime.rs): `apps/desktop/src-tauri/src/runtime.rs`
- [Media import and probe](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/youtube.rs): `apps/desktop/src-tauri/src/youtube.rs`

### Analysis and AI

- [Analysis orchestration](https://github.com/khanh02-vin/alts/blob/main/services/ai-pipeline/index.ts): `services/ai-pipeline/index.ts`
- [Whisper transcription](https://github.com/khanh02-vin/alts/blob/main/adapters/local/chunked-whisper.ts): `adapters/local/chunked-whisper.ts`
- [Transcript contracts](https://github.com/khanh02-vin/alts/blob/main/packages/contracts/transcript.ts): `packages/contracts/transcript.ts`
- [Highlight selection](https://github.com/khanh02-vin/alts/blob/main/services/ai-pipeline/highlight-scoring.ts): `services/ai-pipeline/highlight-scoring.ts`
- [Speaker diarization](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/diarization.rs): `apps/desktop/src-tauri/src/diarization.rs`
- [AI providers](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/providers.rs): `apps/desktop/src-tauri/src/providers.rs`
- [Highlight contracts](https://github.com/khanh02-vin/alts/blob/main/packages/contracts/highlight.ts): `packages/contracts/highlight.ts`

### Editing and rendering

- [Render-plan editing](https://github.com/khanh02-vin/alts/blob/main/packages/editor-core/index.ts): `packages/editor-core/index.ts`
- [Render-plan contract](https://github.com/khanh02-vin/alts/blob/main/packages/contracts/render-plan.ts): `packages/contracts/render-plan.ts`
- [Render commands](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/src/render.rs): `apps/desktop/src-tauri/src/render.rs`
- [FFmpeg renderer](https://github.com/khanh02-vin/alts/blob/main/apps/desktop/src-tauri/crates/render-engine/src/engine.rs): `apps/desktop/src-tauri/crates/render-engine/src/engine.rs`
- [Probe and reframe](https://github.com/khanh02-vin/alts/blob/main/packages/media-engine/reframe/index.ts): `packages/media-engine/reframe/index.ts`

### Web and discovery

- [RAG sidecar](https://github.com/khanh02-vin/alts/blob/main/apps/web/src/routes/api/rag/%2Bserver.ts): `apps/web/src/routes/api/rag/+server.ts`
- [Related video search](https://github.com/khanh02-vin/alts/blob/main/packages/media-engine/related-videos/index.ts): `packages/media-engine/related-videos/index.ts`
- [RAG document store](https://github.com/khanh02-vin/alts/blob/main/apps/web/src/routes/api/rag/%2Bserver.ts): `apps/web/src/routes/api/rag/+server.ts`

### Other components

- **Creator**
- **FFmpeg**
- **Video platforms**
- **Local filesystem and SQLite**

## Connections

- Creator → Studio UI: imports and edits (evidence: `README.md`)
- Studio UI → Tauri commands: invokes (evidence: `README.md`)
- Tauri commands → Project storage: manages projects (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Project storage → Local filesystem and SQLite: reads and writes
- Tauri commands → Runtime services: dispatches analysis (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Tauri commands → Media import and probe: dispatches import (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Media import and probe → Video platforms: fetches link media (evidence: `README.md`)
- Runtime services → Analysis orchestration: runs analysis
- Analysis orchestration → Whisper transcription: transcribes audio (evidence: `services/ai-pipeline/index.ts`)
- Whisper transcription → Transcript contracts: produces transcript (evidence: `adapters/local/chunked-whisper.ts`)
- Analysis orchestration → Highlight selection: selects highlights (evidence: `services/ai-pipeline/index.ts`)
- Analysis orchestration → Highlight contracts: validates highlights (evidence: `services/ai-pipeline/index.ts`)
- Analysis orchestration → Speaker diarization: adds speakers
- Analysis orchestration → AI providers: uses configured models
- Studio UI → Render-plan editing: edits selected cuts (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Render-plan editing → Render-plan contract: validates plan (evidence: `packages/editor-core/index.ts`)
- Tauri commands → Render commands: dispatches render (evidence: `apps/desktop/src-tauri/src/main.rs`)
- Render commands → FFmpeg renderer: renders plan (evidence: `README.md`)
- FFmpeg renderer → FFmpeg: encodes video (evidence: `README.md`)
- FFmpeg renderer → Local filesystem and SQLite: writes MP4 (evidence: `README.md`)
- Studio UI → Probe and reframe: uses media tools
- Studio UI → Related video search: searches related videos (evidence: `apps/web/src/lib/pages/Studio.svelte`)
- Related video search → Video platforms: queries videos
- RAG sidecar → RAG document store: reads and writes (evidence: `apps/web/src/routes/api/rag/+server.ts`)
- RAG sidecar → Related video search: supports discovery (evidence: `apps/web/src/routes/api/rag/+server.ts`)
