# pheliperr/aethera-studio architecture

> Architecture diagram of the GitHub repository pheliperr/aethera-studio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pheliperr/aethera-studio
- Repository: https://github.com/pheliperr/aethera-studio

## Overview

Aethera Studio is the repository’s featured product: a local-first desktop audiovisual studio that turns a creator’s prompt into a researched, edited, narrated, and rendered video. The documented workflow runs through staged production, media acquisition and validation, timeline assembly, audio, quality review, and MP4 preview/export; related capabilities include Trend Radar, Creative Studio, editorial calendar, managed media, TTS, and YouTube publishing. Edges are limited to README relationships and source-index references visible in the supplied excerpts; unverified optional integrations are dashed.

Main entry points: [`apps/aethera-desktop/src/main/index.ts`](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/index.ts) (Electron main), [`apps/aethera-desktop/src/main/cinema-pipeline.ts`](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/cinema-pipeline.ts) (Staged production), [`packages/cinema/src/ir/timeline-ir.ts`](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/ir/timeline-ir.ts) (Timeline model), [`packages/cinema/src`](https://github.com/pheliperr/aethera-studio/tree/main/packages/cinema/src) (Cinema engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Desktop entry"]
  node_renderer["Aethera interface<br/>[App.tsx]"]
  node_preload["Isolated bridge<br/>[index.ts]"]
  node_ipc["Domain IPC<br/>[aethera-ipc.ts]"]
  node_main["Electron main<br/>[index.ts]"]
end

subgraph group_production["Video production"]
  node_pipeline["Staged production<br/>[cinema-pipeline.ts]"]
  node_console["Production console"]
  node_cinema["Cinema engine"]
  node_timeline["Timeline model<br/>[timeline-ir.ts]"]
  node_media["Media intelligence"]
  node_editor["Editorial engine"]
  node_audio["Sound engine<br/>[sound-engine.ts]"]
  node_qc["Quality control<br/>[qc-engine.ts]"]
  node_probe["MP4 probe"]
  node_calendar["Editorial calendar"]
  node_evolution["Production learning<br/>[evolution-core.ts]"]
  node_academy["Academy<br/>[academy-engine.ts]"]
end

subgraph group_creative["Creative services"]
  node_trend["Trend Radar<br/>[trend-radar.ts]"]
  node_studio["Creative Studio<br/>[concept-engine.ts]"]
  node_tts["Narration providers<br/>[tts-providers.ts]"]
  node_library["Managed media"]
end

subgraph group_persistence["Local data"]
  node_store[("SQLite database<br/>[schema.ts]")]
  node_review["Review repository"]
  node_studio_repo["Studio repository"]
end

node_creator(("Creator"))
node_youtube["YouTube"]
node_agents["Agent CLIs"]
node_local_ai["Local AI models"]

node_creator -->|"creates with"| node_renderer
node_renderer -->|"invokes"| node_preload
node_preload -->|"sends IPC"| node_ipc
node_ipc -->|"routes requests"| node_main
node_main -->|"starts production"| node_pipeline
node_pipeline -->|"uses engine"| node_cinema
node_pipeline -->|"records stages"| node_console
node_cinema -.->|"analyzes media"| node_media
node_cinema -.->|"edits timeline"| node_editor
node_editor -->|"uses model"| node_timeline
node_media -->|"uses model"| node_timeline
node_audio -->|"uses model"| node_timeline
node_qc -->|"checks timeline"| node_timeline
node_pipeline -->|"probes render"| node_probe
node_academy -->|"uses learning core"| node_evolution
node_main -.->|"offers feature"| node_trend
node_main -.->|"offers feature"| node_studio
node_main -.->|"offers calendar"| node_calendar
node_main -.->|"provides narration"| node_tts
node_main -.->|"manages media"| node_library
node_pipeline -.->|"requests research"| node_agents
node_studio -.->|"generates locally"| node_local_ai
node_trend -.->|"requests synthesis"| node_agents
node_main -.->|"publishes upload"| node_youtube
node_pipeline -.->|"persists runs"| node_studio_repo
node_review -->|"reads and writes"| node_store
node_main -.->|"uses SQLite"| node_store

click node_renderer "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/renderer/src/App.tsx"
click node_preload "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/preload/index.ts"
click node_ipc "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/aethera-ipc.ts"
click node_main "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/index.ts"
click node_pipeline "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/cinema-pipeline.ts"
click node_console "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/production-console.ts"
click node_cinema "https://github.com/pheliperr/aethera-studio/tree/main/packages/cinema/src"
click node_timeline "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/ir/timeline-ir.ts"
click node_media "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/analysis/media-intelligence.ts"
click node_editor "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/edit/editorial-engine.ts"
click node_audio "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/audio/sound-engine.ts"
click node_qc "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/qc/qc-engine.ts"
click node_probe "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/qc/real-media-probe.ts"
click node_calendar "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/calendar/editorial-calendar-engine.ts"
click node_evolution "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/evolution/evolution-core.ts"
click node_academy "https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/evolution/academy-engine.ts"
click node_trend "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/trend-radar.ts"
click node_studio "https://github.com/pheliperr/aethera-studio/blob/main/packages/creative-studio/src/concept-engine.ts"
click node_tts "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/tts-providers.ts"
click node_library "https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/managed-media-library.ts"
click node_store "https://github.com/pheliperr/aethera-studio/blob/main/packages/database/src/schema.ts"
click node_review "https://github.com/pheliperr/aethera-studio/blob/main/packages/database/src/aethera-review-repository.ts"
click node_studio_repo "https://github.com/pheliperr/aethera-studio/blob/main/packages/database/src/aethera-studio-repository.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_renderer,node_preload,node_ipc,node_main toneBlue
class node_pipeline,node_console,node_cinema,node_timeline,node_media,node_editor,node_audio,node_qc,node_probe,node_calendar,node_evolution,node_academy toneAmber
class node_trend,node_studio,node_tts,node_library toneMint
class node_store,node_review,node_studio_repo toneRose
class node_creator,node_youtube,node_agents,node_local_ai toneIndigo
```

## Components

### Desktop entry

- [Aethera interface](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/renderer/src/App.tsx): `apps/aethera-desktop/src/renderer/src/App.tsx`
- [Isolated bridge](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/preload/index.ts): `apps/aethera-desktop/src/preload/index.ts`
- [Domain IPC](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/aethera-ipc.ts): `apps/aethera-desktop/src/main/aethera-ipc.ts`
- [Electron main](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/index.ts): `apps/aethera-desktop/src/main/index.ts`

### Video production

- [Staged production](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/cinema-pipeline.ts): `apps/aethera-desktop/src/main/cinema-pipeline.ts`
- [Production console](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/production-console.ts): `apps/aethera-desktop/src/main/production-console.ts`
- [Cinema engine](https://github.com/pheliperr/aethera-studio/tree/main/packages/cinema/src): `packages/cinema/src`
- [Timeline model](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/ir/timeline-ir.ts): `packages/cinema/src/ir/timeline-ir.ts`
- [Media intelligence](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/analysis/media-intelligence.ts): `packages/cinema/src/analysis/media-intelligence.ts`
- [Editorial engine](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/edit/editorial-engine.ts): `packages/cinema/src/edit/editorial-engine.ts`
- [Sound engine](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/audio/sound-engine.ts): `packages/cinema/src/audio/sound-engine.ts`
- [Quality control](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/qc/qc-engine.ts): `packages/cinema/src/qc/qc-engine.ts`
- [MP4 probe](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/qc/real-media-probe.ts): `packages/cinema/src/qc/real-media-probe.ts`
- [Editorial calendar](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/calendar/editorial-calendar-engine.ts): `packages/cinema/src/calendar/editorial-calendar-engine.ts`
- [Production learning](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/evolution/evolution-core.ts): `packages/cinema/src/evolution/evolution-core.ts`
- [Academy](https://github.com/pheliperr/aethera-studio/blob/main/packages/cinema/src/evolution/academy-engine.ts): `packages/cinema/src/evolution/academy-engine.ts`

### Creative services

- [Trend Radar](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/trend-radar.ts): `apps/aethera-desktop/src/main/trend-radar.ts`
- [Creative Studio](https://github.com/pheliperr/aethera-studio/blob/main/packages/creative-studio/src/concept-engine.ts): `packages/creative-studio/src/concept-engine.ts`
- [Narration providers](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/tts-providers.ts): `apps/aethera-desktop/src/main/tts-providers.ts`
- [Managed media](https://github.com/pheliperr/aethera-studio/blob/main/apps/aethera-desktop/src/main/managed-media-library.ts): `apps/aethera-desktop/src/main/managed-media-library.ts`

### Local data

- [SQLite database](https://github.com/pheliperr/aethera-studio/blob/main/packages/database/src/schema.ts): `packages/database/src/schema.ts`
- [Review repository](https://github.com/pheliperr/aethera-studio/blob/main/packages/database/src/aethera-review-repository.ts): `packages/database/src/aethera-review-repository.ts`
- [Studio repository](https://github.com/pheliperr/aethera-studio/blob/main/packages/database/src/aethera-studio-repository.ts): `packages/database/src/aethera-studio-repository.ts`

### Other components

- **Creator**
- **YouTube**
- **Agent CLIs**
- **Local AI models**

## Connections

- Creator → Aethera interface: creates with
- Aethera interface → Isolated bridge: invokes
- Isolated bridge → Domain IPC: sends IPC
- Domain IPC → Electron main: routes requests
- Electron main → Staged production: starts production
- Staged production → Cinema engine: uses engine (evidence: `apps/aethera-desktop/src/main/cinema-pipeline.ts`)
- Staged production → Production console: records stages (evidence: `apps/aethera-desktop/src/main/cinema-pipeline.ts`)
- Cinema engine → Media intelligence: analyzes media (evidence: `packages/cinema/src/edit/editorial-engine.ts`)
- Cinema engine → Editorial engine: edits timeline (evidence: `packages/cinema/src/edit/editorial-engine.ts`)
- Editorial engine → Timeline model: uses model (evidence: `packages/cinema/src/edit/editorial-engine.ts`)
- Media intelligence → Timeline model: uses model (evidence: `packages/cinema/src/analysis/media-intelligence.ts`)
- Sound engine → Timeline model: uses model (evidence: `packages/cinema/src/audio/sound-engine.ts`)
- Quality control → Timeline model: checks timeline (evidence: `packages/cinema/src/qc/qc-engine.ts`)
- Staged production → MP4 probe: probes render (evidence: `apps/aethera-desktop/src/main/cinema-pipeline.ts`)
- Academy → Production learning: uses learning core (evidence: `packages/cinema/src/evolution/academy-engine.ts`)
- Electron main → Trend Radar: offers feature
- Electron main → Creative Studio: offers feature
- Electron main → Editorial calendar: offers calendar
- Electron main → Narration providers: provides narration
- Electron main → Managed media: manages media
- Staged production → Agent CLIs: requests research
- Creative Studio → Local AI models: generates locally
- Trend Radar → Agent CLIs: requests synthesis
- Electron main → YouTube: publishes upload
- Staged production → Studio repository: persists runs
- Review repository → SQLite database: reads and writes (evidence: `packages/database/src/aethera-review-repository.ts`)
- Electron main → SQLite database: uses SQLite
