# sdijf1521/xb-svcb architecture

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

- Interactive diagram: https://gitdiagram.com/sdijf1521/xb-svcb
- Repository: https://github.com/sdijf1521/xb-svcb

## Overview

XB-SVCB is a Windows desktop AI singing-conversion and audio-creation workstation. The main workflow imports a song, separates vocals, converts them with a selected model, enhances and mixes the result, then lets the user audition, export, or edit it. The graph also preserves documented branches for realtime conversion, model and music catalogs, plugins, and external HTTP access. Edges follow the README’s architecture and capability descriptions plus visible source references; unsampled service internals are not asserted beyond those documented connections.

Main entry points: [`app/api/bridge.py`](https://github.com/sdijf1521/xb-svcb/blob/master/app/api/bridge.py) (Bridge API), [`app/application/conversion_service.py`](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/conversion_service.py) (Conversion service), [`app/infrastructure/engine.py`](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/engine.py) (Engine registry), [`app/infrastructure/storage.py`](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/storage.py) (Local repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_ui["Desktop UI<br/>[App.vue]"]
  node_create["Song creation<br/>[create.vue]"]
  node_editor_ui["Editor UI<br/>[editor.vue]"]
  node_http["FastAPI server<br/>[http_server.py]"]
  node_bridge["Bridge API<br/>[bridge.py]"]
  node_i18n["Translations<br/>[extraPhrases.ts]"]
end

subgraph group_services["Application services"]
  node_conversion["Conversion service"]
  node_realtime["Realtime conversion"]
  node_editor_service["Editor service"]
  node_model_service["Model management<br/>[model_service.py]"]
  node_hub["Model hub"]
  node_music["Music catalog<br/>[music_service.py]"]
  node_works["Works library<br/>[work_service.py]"]
  node_plugins["Plugin service<br/>[plugin_service.py]"]
  node_system["System service<br/>[system_service.py]"]
end

subgraph group_audio["Audio processing"]
  node_engine_registry["Engine registry<br/>[engine.py]"]
  node_svc_engine["So-VITS engine<br/>[svc_engine.py]"]
  node_rvc_engine["RVC engine<br/>[rvc_engine.py]"]
  node_seed_engine["SeedVC engine<br/>[seedvc_engine.py]"]
  node_ddsp_engine["DDSP engine<br/>[ddsp_engine.py]"]
  node_uvr["Vocal separation<br/>[uvr_tool.py]"]
  node_enhancement["Vocal enhancement"]
  node_ffmpeg["Audio tools<br/>[ffmpeg_tool.py]"]
  node_audio_engine["Editor renderer<br/>[audio_engine.py]"]
  node_device["Inference devices"]
  node_worker_runtime["Worker runtime"]
  node_vst_host["VST3 host<br/>[juce_vst3_host.py]"]
end

subgraph group_assets["Models and data"]
  node_storage[("Local repositories<br/>[storage.py]")]
  node_paths["User data paths<br/>[paths.py]"]
  node_config["Runtime config<br/>[config.py]"]
end

subgraph group_extensions["External capabilities"]
  node_modelscope["ModelScope"]
  node_music_providers["Music providers"]
end

node_user(("Desktop user"))
node_client(("HTTP client"))

node_user -->|"uses"| node_ui
node_ui -->|"calls"| node_bridge
node_client -->|"submits requests"| node_http
node_http -->|"reuses facade"| node_bridge
node_bridge -->|"dispatches"| node_conversion
node_bridge -->|"dispatches"| node_model_service
node_bridge -->|"dispatches"| node_editor_service
node_bridge -->|"dispatches"| node_plugins
node_create -->|"submits tasks"| node_bridge
node_editor_ui -->|"calls editor API"| node_bridge
node_conversion -->|"separates vocals"| node_uvr
node_conversion -->|"selects framework"| node_engine_registry
node_engine_registry -->|"routes inference"| node_svc_engine
node_engine_registry -->|"routes inference"| node_rvc_engine
node_engine_registry -->|"routes inference"| node_seed_engine
node_engine_registry -->|"routes inference"| node_ddsp_engine
node_conversion -->|"enhances vocals"| node_enhancement
node_conversion -->|"mixes audio"| node_ffmpeg
node_conversion -->|"stores work state"| node_storage
node_editor_service -->|"renders projects"| node_audio_engine
node_editor_service -->|"stores projects"| node_storage
node_audio_engine -->|"uses effects host"| node_vst_host
node_realtime -->|"separates vocals"| node_uvr
node_realtime -->|"converts vocals"| node_engine_registry
node_realtime -->|"remixes audio"| node_ffmpeg
node_realtime -->|"reads model data"| node_storage
node_model_service -->|"persists models"| node_storage
node_hub -->|"updates model data"| node_storage
node_hub -->|"searches and transfers"| node_modelscope
node_music -->|"searches catalog"| node_music_providers
node_works -.->|"manages works"| node_storage
node_engine_registry -->|"launches workers"| node_worker_runtime
node_svc_engine -->|"selects device"| node_device
node_rvc_engine -->|"selects device"| node_device
node_seed_engine -->|"selects device"| node_device
node_paths -->|"uses data paths"| node_config
node_conversion -->|"uses work paths"| node_paths
node_plugins -.->|"uses plugin data"| node_storage
node_ui -->|"loads translations"| node_i18n

click node_ui "https://github.com/sdijf1521/xb-svcb/blob/master/web/src/App.vue"
click node_create "https://github.com/sdijf1521/xb-svcb/blob/master/web/src/views/create/create.vue"
click node_editor_ui "https://github.com/sdijf1521/xb-svcb/blob/master/web/src/views/editor/editor.vue"
click node_http "https://github.com/sdijf1521/xb-svcb/blob/master/app/api/http_server.py"
click node_bridge "https://github.com/sdijf1521/xb-svcb/blob/master/app/api/bridge.py"
click node_conversion "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/conversion_service.py"
click node_realtime "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/realtime_cover_service.py"
click node_editor_service "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/audio_editor_service.py"
click node_model_service "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/model_service.py"
click node_hub "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/model_hub_service.py"
click node_music "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/music_service.py"
click node_works "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/work_service.py"
click node_plugins "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/plugin_service.py"
click node_system "https://github.com/sdijf1521/xb-svcb/blob/master/app/application/system_service.py"
click node_engine_registry "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/engine.py"
click node_svc_engine "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/svc_engine.py"
click node_rvc_engine "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/rvc_engine.py"
click node_seed_engine "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/seedvc_engine.py"
click node_ddsp_engine "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/ddsp_engine.py"
click node_uvr "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/uvr_tool.py"
click node_enhancement "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/vocal_enhancement.py"
click node_ffmpeg "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/ffmpeg_tool.py"
click node_audio_engine "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/audio_engine.py"
click node_device "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/inference_device.py"
click node_worker_runtime "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/persistent_worker.py"
click node_vst_host "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/juce_vst3_host.py"
click node_storage "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/storage.py"
click node_paths "https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/paths.py"
click node_config "https://github.com/sdijf1521/xb-svcb/blob/master/app/config.py"
click node_i18n "https://github.com/sdijf1521/xb-svcb/blob/master/web/src/i18n/extraPhrases.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_create,node_editor_ui,node_http,node_bridge,node_i18n,node_user,node_client toneBlue
class node_conversion,node_realtime,node_editor_service,node_model_service,node_hub,node_music,node_works,node_plugins,node_system toneAmber
class node_engine_registry,node_svc_engine,node_rvc_engine,node_seed_engine,node_ddsp_engine,node_uvr,node_enhancement,node_ffmpeg,node_audio_engine,node_device,node_worker_runtime,node_vst_host toneMint
class node_storage,node_paths,node_config toneRose
class node_modelscope,node_music_providers toneIndigo
```

## Components

### User experience

- [Desktop UI](https://github.com/sdijf1521/xb-svcb/blob/master/web/src/App.vue): `web/src/App.vue`
- [Song creation](https://github.com/sdijf1521/xb-svcb/blob/master/web/src/views/create/create.vue): `web/src/views/create/create.vue`
- [Editor UI](https://github.com/sdijf1521/xb-svcb/blob/master/web/src/views/editor/editor.vue): `web/src/views/editor/editor.vue`
- [FastAPI server](https://github.com/sdijf1521/xb-svcb/blob/master/app/api/http_server.py): `app/api/http_server.py`
- [Bridge API](https://github.com/sdijf1521/xb-svcb/blob/master/app/api/bridge.py): `app/api/bridge.py`
- [Translations](https://github.com/sdijf1521/xb-svcb/blob/master/web/src/i18n/extraPhrases.ts): `web/src/i18n/extraPhrases.ts`

### Application services

- [Conversion service](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/conversion_service.py): `app/application/conversion_service.py`
- [Realtime conversion](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/realtime_cover_service.py): `app/application/realtime_cover_service.py`
- [Editor service](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/audio_editor_service.py): `app/application/audio_editor_service.py`
- [Model management](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/model_service.py): `app/application/model_service.py`
- [Model hub](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/model_hub_service.py): `app/application/model_hub_service.py`
- [Music catalog](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/music_service.py): `app/application/music_service.py`
- [Works library](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/work_service.py): `app/application/work_service.py`
- [Plugin service](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/plugin_service.py): `app/application/plugin_service.py`
- [System service](https://github.com/sdijf1521/xb-svcb/blob/master/app/application/system_service.py): `app/application/system_service.py`

### Audio processing

- [Engine registry](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/engine.py): `app/infrastructure/engine.py`
- [So-VITS engine](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/svc_engine.py): `app/infrastructure/svc_engine.py`
- [RVC engine](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/rvc_engine.py): `app/infrastructure/rvc_engine.py`
- [SeedVC engine](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/seedvc_engine.py): `app/infrastructure/seedvc_engine.py`
- [DDSP engine](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/ddsp_engine.py): `app/infrastructure/ddsp_engine.py`
- [Vocal separation](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/uvr_tool.py): `app/infrastructure/uvr_tool.py`
- [Vocal enhancement](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/vocal_enhancement.py): `app/infrastructure/vocal_enhancement.py`
- [Audio tools](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/ffmpeg_tool.py): `app/infrastructure/ffmpeg_tool.py`
- [Editor renderer](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/audio_engine.py): `app/infrastructure/audio_engine.py`
- [Inference devices](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/inference_device.py): `app/infrastructure/inference_device.py`
- [Worker runtime](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/persistent_worker.py): `app/infrastructure/persistent_worker.py`
- [VST3 host](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/juce_vst3_host.py): `app/infrastructure/juce_vst3_host.py`

### Models and data

- [Local repositories](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/storage.py): `app/infrastructure/storage.py`
- [User data paths](https://github.com/sdijf1521/xb-svcb/blob/master/app/infrastructure/paths.py): `app/infrastructure/paths.py`
- [Runtime config](https://github.com/sdijf1521/xb-svcb/blob/master/app/config.py): `app/config.py`

### External capabilities

- **ModelScope**
- **Music providers**

### Other components

- **Desktop user**
- **HTTP client**

## Connections

- Desktop user → Desktop UI: uses
- Desktop UI → Bridge API: calls
- HTTP client → FastAPI server: submits requests
- FastAPI server → Bridge API: reuses facade (evidence: `app/api/http_server.py`)
- Bridge API → Conversion service: dispatches
- Bridge API → Model management: dispatches
- Bridge API → Editor service: dispatches
- Bridge API → Plugin service: dispatches
- Song creation → Bridge API: submits tasks
- Editor UI → Bridge API: calls editor API
- Conversion service → Vocal separation: separates vocals (evidence: `app/application/conversion_service.py`)
- Conversion service → Engine registry: selects framework (evidence: `app/application/conversion_service.py`)
- Engine registry → So-VITS engine: routes inference
- Engine registry → RVC engine: routes inference
- Engine registry → SeedVC engine: routes inference
- Engine registry → DDSP engine: routes inference
- Conversion service → Vocal enhancement: enhances vocals (evidence: `app/application/conversion_service.py`)
- Conversion service → Audio tools: mixes audio (evidence: `app/application/conversion_service.py`)
- Conversion service → Local repositories: stores work state (evidence: `app/application/conversion_service.py`)
- Editor service → Editor renderer: renders projects (evidence: `app/application/audio_editor_service.py`)
- Editor service → Local repositories: stores projects (evidence: `app/application/audio_editor_service.py`)
- Editor renderer → VST3 host: uses effects host (evidence: `app/application/audio_editor_service.py`)
- Realtime conversion → Vocal separation: separates vocals (evidence: `app/application/realtime_cover_service.py`)
- Realtime conversion → Engine registry: converts vocals (evidence: `app/application/realtime_cover_service.py`)
- Realtime conversion → Audio tools: remixes audio (evidence: `app/application/realtime_cover_service.py`)
- Realtime conversion → Local repositories: reads model data (evidence: `app/application/realtime_cover_service.py`)
- Model management → Local repositories: persists models (evidence: `app/application/model_service.py`)
- Model hub → Local repositories: updates model data (evidence: `app/application/model_hub_service.py`)
- Model hub → ModelScope: searches and transfers
- Music catalog → Music providers: searches catalog
- Works library → Local repositories: manages works
- Engine registry → Worker runtime: launches workers
- So-VITS engine → Inference devices: selects device (evidence: `app/infrastructure/svc_engine.py`)
- RVC engine → Inference devices: selects device (evidence: `app/infrastructure/rvc_engine.py`)
- SeedVC engine → Inference devices: selects device (evidence: `app/infrastructure/seedvc_engine.py`)
- User data paths → Runtime config: uses data paths (evidence: `app/infrastructure/paths.py`)
- Conversion service → User data paths: uses work paths (evidence: `app/application/conversion_service.py`)
- Plugin service → Local repositories: uses plugin data
- Desktop UI → Translations: loads translations
