# duixcom/duix-avatar architecture

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

- Interactive diagram: https://gitdiagram.com/duixcom/duix-avatar
- Repository: https://github.com/duixcom/duix-avatar

## Overview

Duix.Avatar is an Electron desktop app for managing avatar models and creating synthesized videos. The main user flow is to choose or create a model, prepare text or uploaded media and voice settings, then preview or produce a video. The renderer, main-process services, and local database are visible in sampled code; the README describes offline cloning and synthesis capabilities, but implementation details for several stages were not sampled. FFmpeg headers are included as a bundled media API surface, not evidence of specific application calls.

Main entry points: [`src/main/service/index.js`](https://github.com/duixcom/duix-avatar/blob/main/src/main/service/index.js) (Service Registry), [`src/renderer/src/views/video-edit/VideoEditView.vue`](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/VideoEditView.vue) (Video Editor), [`src/main/util/ffmpeg.js`](https://github.com/duixcom/duix-avatar/blob/main/src/main/util/ffmpeg.js) (FFmpeg Utility), [`src/main/index.js`](https://github.com/duixcom/duix-avatar/blob/main/src/main/index.js) (Electron Main)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop Interface"]
  node_app_shell["App Shell<br/>[App.vue]"]
  node_home["Home &amp; Models<br/>[index.vue]"]
  node_model_create["Model Creation"]
  node_video_edit["Video Editor<br/>[VideoEditView.vue]"]
  node_text_edit["Text &amp; Voice<br/>[EditText.vue]"]
  node_upload_edit["Media Upload<br/>[EditUpload.vue]"]
  node_preview["Video Preview<br/>[PreviewView.vue]"]
  node_renderer_api["Renderer API<br/>[index.js]"]
end

subgraph group_services["Main Process"]
  node_main["Electron Main<br/>[index.js]"]
  node_handlers["IPC Handlers<br/>[index.js]"]
  node_service_registry["Service Registry<br/>[index.js]"]
  node_context_service["Context Service<br/>[context.js]"]
end

subgraph group_media["Media Capabilities"]
  node_video_service["Video Synthesis<br/>[video.js]"]
  node_model_service["Model Management<br/>[model.js]"]
  node_voice_service["Voice Services<br/>[voice.js]"]
  node_tts_api["TTS API<br/>[tts.js]"]
  node_ffmpeg_util["FFmpeg Utility<br/>[ffmpeg.js]"]
  node_ffmpeg_codec["Codec API<br/>[avcodec.h]"]
  node_ffmpeg_format["Format &amp; I/O API<br/>[avio.h]"]
  node_ffmpeg_util_api["Media Utility API<br/>[avutil.h]"]
end

subgraph group_storage["Local State"]
  node_database[("SQLite Database<br/>[index.js]")]
  node_context_dao["Context DAO<br/>[context.js]"]
  node_db_schema["Schema &amp; Migrations<br/>[sql.js]"]
end

node_user(("Creator"))
node_local_inference["Local Inference"]

node_user -.->|"browses"| node_home
node_user -.->|"creates model"| node_model_create
node_user -.->|"prepares video"| node_video_edit
node_video_edit -.->|"edits script"| node_text_edit
node_video_edit -.->|"adds media"| node_upload_edit
node_video_edit -.->|"previews result"| node_preview
node_app_shell -->|"loads context"| node_renderer_api
node_main -->|"initializes"| node_database
node_main -->|"registers services"| node_service_registry
node_main -->|"registers handlers"| node_handlers
node_handlers -.->|"routes requests"| node_service_registry
node_service_registry -.->|"registers"| node_video_service
node_service_registry -.->|"registers"| node_model_service
node_service_registry -.->|"registers"| node_voice_service
node_service_registry -.->|"registers"| node_context_service
node_context_service -->|"uses"| node_context_dao
node_context_dao -->|"queries"| node_database
node_database -->|"applies migrations"| node_db_schema
node_video_service -.->|"invokes synthesis"| node_local_inference
node_model_service -.->|"uses model runtime"| node_local_inference
node_voice_service -.->|"uses speech"| node_tts_api
node_video_service -.->|"processes media"| node_ffmpeg_util
node_ffmpeg_util -.->|"uses codec API"| node_ffmpeg_codec
node_ffmpeg_util -.->|"uses format API"| node_ffmpeg_format
node_ffmpeg_util -.->|"uses utility API"| node_ffmpeg_util_api

click node_app_shell "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/App.vue"
click node_home "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/home/index.vue"
click node_model_create "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/components/model-create/ModelCreateView.vue"
click node_video_edit "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/VideoEditView.vue"
click node_text_edit "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/edit/EditText.vue"
click node_upload_edit "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/edit/EditUpload.vue"
click node_preview "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/preview/PreviewView.vue"
click node_renderer_api "https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/api/index.js"
click node_main "https://github.com/duixcom/duix-avatar/blob/main/src/main/index.js"
click node_handlers "https://github.com/duixcom/duix-avatar/blob/main/src/main/handlers/index.js"
click node_service_registry "https://github.com/duixcom/duix-avatar/blob/main/src/main/service/index.js"
click node_video_service "https://github.com/duixcom/duix-avatar/blob/main/src/main/service/video.js"
click node_model_service "https://github.com/duixcom/duix-avatar/blob/main/src/main/service/model.js"
click node_voice_service "https://github.com/duixcom/duix-avatar/blob/main/src/main/service/voice.js"
click node_context_service "https://github.com/duixcom/duix-avatar/blob/main/src/main/service/context.js"
click node_tts_api "https://github.com/duixcom/duix-avatar/blob/main/src/main/api/tts.js"
click node_ffmpeg_util "https://github.com/duixcom/duix-avatar/blob/main/src/main/util/ffmpeg.js"
click node_ffmpeg_codec "https://github.com/duixcom/duix-avatar/blob/main/resources/ffmpeg/win-amd64/include/libavcodec/avcodec.h"
click node_ffmpeg_format "https://github.com/duixcom/duix-avatar/blob/main/resources/ffmpeg/win-amd64/include/libavformat/avio.h"
click node_ffmpeg_util_api "https://github.com/duixcom/duix-avatar/blob/main/resources/ffmpeg/win-amd64/include/libavutil/avutil.h"
click node_database "https://github.com/duixcom/duix-avatar/blob/main/src/main/db/index.js"
click node_context_dao "https://github.com/duixcom/duix-avatar/blob/main/src/main/dao/context.js"
click node_db_schema "https://github.com/duixcom/duix-avatar/blob/main/src/main/db/sql.js"

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_app_shell,node_home,node_model_create,node_video_edit,node_text_edit,node_upload_edit,node_preview,node_renderer_api toneBlue
class node_main,node_handlers,node_service_registry,node_context_service toneAmber
class node_video_service,node_model_service,node_voice_service,node_tts_api,node_ffmpeg_util,node_ffmpeg_codec,node_ffmpeg_format,node_ffmpeg_util_api toneMint
class node_database,node_context_dao,node_db_schema toneRose
class node_user,node_local_inference toneIndigo
```

## Components

### Desktop Interface

- [App Shell](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/App.vue): `src/renderer/src/App.vue`
- [Home & Models](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/home/index.vue): `src/renderer/src/views/home/index.vue`
- [Model Creation](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/components/model-create/ModelCreateView.vue): `src/renderer/src/components/model-create/ModelCreateView.vue`
- [Video Editor](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/VideoEditView.vue): `src/renderer/src/views/video-edit/VideoEditView.vue`
- [Text & Voice](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/edit/EditText.vue): `src/renderer/src/views/video-edit/edit/EditText.vue`
- [Media Upload](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/edit/EditUpload.vue): `src/renderer/src/views/video-edit/edit/EditUpload.vue`
- [Video Preview](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/views/video-edit/preview/PreviewView.vue): `src/renderer/src/views/video-edit/preview/PreviewView.vue`
- [Renderer API](https://github.com/duixcom/duix-avatar/blob/main/src/renderer/src/api/index.js): `src/renderer/src/api/index.js`

### Main Process

- [Electron Main](https://github.com/duixcom/duix-avatar/blob/main/src/main/index.js): `src/main/index.js`
- [IPC Handlers](https://github.com/duixcom/duix-avatar/blob/main/src/main/handlers/index.js): `src/main/handlers/index.js`
- [Service Registry](https://github.com/duixcom/duix-avatar/blob/main/src/main/service/index.js): `src/main/service/index.js`
- [Context Service](https://github.com/duixcom/duix-avatar/blob/main/src/main/service/context.js): `src/main/service/context.js`

### Media Capabilities

- [Video Synthesis](https://github.com/duixcom/duix-avatar/blob/main/src/main/service/video.js): `src/main/service/video.js`
- [Model Management](https://github.com/duixcom/duix-avatar/blob/main/src/main/service/model.js): `src/main/service/model.js`
- [Voice Services](https://github.com/duixcom/duix-avatar/blob/main/src/main/service/voice.js): `src/main/service/voice.js`
- [TTS API](https://github.com/duixcom/duix-avatar/blob/main/src/main/api/tts.js): `src/main/api/tts.js`
- [FFmpeg Utility](https://github.com/duixcom/duix-avatar/blob/main/src/main/util/ffmpeg.js): `src/main/util/ffmpeg.js`
- [Codec API](https://github.com/duixcom/duix-avatar/blob/main/resources/ffmpeg/win-amd64/include/libavcodec/avcodec.h): `resources/ffmpeg/win-amd64/include/libavcodec/avcodec.h`
- [Format & I/O API](https://github.com/duixcom/duix-avatar/blob/main/resources/ffmpeg/win-amd64/include/libavformat/avio.h): `resources/ffmpeg/win-amd64/include/libavformat/avio.h`
- [Media Utility API](https://github.com/duixcom/duix-avatar/blob/main/resources/ffmpeg/win-amd64/include/libavutil/avutil.h): `resources/ffmpeg/win-amd64/include/libavutil/avutil.h`

### Local State

- [SQLite Database](https://github.com/duixcom/duix-avatar/blob/main/src/main/db/index.js): `src/main/db/index.js`
- [Context DAO](https://github.com/duixcom/duix-avatar/blob/main/src/main/dao/context.js): `src/main/dao/context.js`
- [Schema & Migrations](https://github.com/duixcom/duix-avatar/blob/main/src/main/db/sql.js): `src/main/db/sql.js`

### Other components

- **Creator**
- **Local Inference**

## Connections

- Creator → Home & Models: browses (evidence: `README.md`)
- Creator → Model Creation: creates model (evidence: `README.md`)
- Creator → Video Editor: prepares video (evidence: `README.md`)
- Video Editor → Text & Voice: edits script
- Video Editor → Media Upload: adds media
- Video Editor → Video Preview: previews result
- App Shell → Renderer API: loads context (evidence: `src/renderer/src/App.vue`)
- Electron Main → SQLite Database: initializes (evidence: `src/main/index.js`)
- Electron Main → Service Registry: registers services (evidence: `src/main/index.js`)
- Electron Main → IPC Handlers: registers handlers (evidence: `src/main/index.js`)
- IPC Handlers → Service Registry: routes requests
- Service Registry → Video Synthesis: registers
- Service Registry → Model Management: registers
- Service Registry → Voice Services: registers
- Service Registry → Context Service: registers
- Context Service → Context DAO: uses (evidence: `src/main/service/context.js`)
- Context DAO → SQLite Database: queries (evidence: `src/main/dao/context.js`)
- SQLite Database → Schema & Migrations: applies migrations (evidence: `src/main/db/index.js`)
- Video Synthesis → Local Inference: invokes synthesis (evidence: `README.md`)
- Model Management → Local Inference: uses model runtime (evidence: `README.md`)
- Voice Services → TTS API: uses speech
- Video Synthesis → FFmpeg Utility: processes media
- FFmpeg Utility → Codec API: uses codec API
- FFmpeg Utility → Format & I/O API: uses format API
- FFmpeg Utility → Media Utility API: uses utility API
