# hacksider/deep-live-cam architecture

> Architecture diagram of the GitHub repository hacksider/deep-live-cam, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hacksider/deep-live-cam
- Repository: https://github.com/hacksider/deep-live-cam
- Video tour (about a minute): https://gitdiagram.com/hacksider/deep-live-cam/video

## Overview

Deep-Live-Cam is a desktop face-swapping application for live camera feeds and image/video targets. Users select a source face and target or camera, configure face mapping and processing options, then run the live or file-processing workflow; output preserves video properties such as FPS/audio when configured. The graph reflects the documented capabilities and sampled orchestration/model code; unsampled capture and output details are represented only at the subsystem level.

Main entry points: [`modules/core.py`](https://github.com/hacksider/deep-live-cam/blob/main/modules/core.py) (App Orchestrator), [`modules/processors/frame/core.py`](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/core.py) (Frame Pipeline), [`modules/ui.py`](https://github.com/hacksider/deep-live-cam/blob/main/modules/ui.py) (Desktop UI), [`modules/face_analyser.py`](https://github.com/hacksider/deep-live-cam/blob/main/modules/face_analyser.py) (Face Analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_ui["Desktop UI<br/>[ui.py]"]
  node_core["App Orchestrator<br/>[core.py]"]
  node_globals["App Settings<br/>[globals.py]"]
end

subgraph group_vision["Face Processing"]
  node_analysis["Face Analysis<br/>[face_analyser.py]"]
  node_mapping["Face Mapping<br/>[face_swapper.py]"]
  node_masking["Face Masks<br/>[face_masking.py]"]
  node_enhancers["Face Enhancers<br/>[face_enhancer.py]"]
  node_gpen256["GPEN 256"]
  node_gpen512["GPEN 512"]
end

subgraph group_media["Media I/O"]
  node_capture["Live Capture<br/>[capturer.py]"]
  node_video_capture["Video Capture<br/>[video_capture.py]"]
  node_frame_core["Frame Pipeline<br/>[core.py]"]
  node_media_utils["Media Utilities<br/>[utilities.py]"]
end

subgraph group_runtime["Runtime Support"]
  node_model_store[("Model Files")]
  node_downloader["Model Manager"]
  node_gpu["GPU Processing<br/>[gpu_processing.py]"]
  node_onnx_opt["ONNX Optimization<br/>[onnx_optimize.py]"]
  node_nsfw["Content Check<br/>[ui.py]"]
end

node_user(("User"))
node_camera(("Camera"))
node_target["Target Media"]
node_output["Output Media"]

node_user -->|"configures"| node_ui
node_ui -->|"starts workflow"| node_core
node_core -->|"initializes"| node_ui
node_ui -->|"sets options"| node_globals
node_core -->|"dispatches processing"| node_frame_core
node_camera -->|"supplies frames"| node_capture
node_capture -->|"streams frames"| node_core
node_target -->|"provides media"| node_core
node_core -->|"reads video"| node_video_capture
node_core -->|"uses media operations"| node_media_utils
node_frame_core -->|"requests face analysis"| node_analysis
node_frame_core -->|"dispatches swapping"| node_mapping
node_frame_core -->|"dispatches enhancement"| node_enhancers
node_frame_core -->|"dispatches enhancement"| node_gpen256
node_frame_core -->|"dispatches enhancement"| node_gpen512
node_mapping -->|"detects faces"| node_analysis
node_mapping -->|"applies masks"| node_masking
node_enhancers -->|"gets faces"| node_analysis
node_downloader -->|"ensures models"| node_model_store
node_enhancers -->|"loads model"| node_downloader
node_analysis -.->|"optimizes model"| node_onnx_opt
node_masking -->|"uses acceleration"| node_gpu
node_frame_core -->|"writes processed media"| node_output
node_core -->|"checks target"| node_nsfw
node_ui -->|"checks media"| node_nsfw

click node_ui "https://github.com/hacksider/deep-live-cam/blob/main/modules/ui.py"
click node_core "https://github.com/hacksider/deep-live-cam/blob/main/modules/core.py"
click node_globals "https://github.com/hacksider/deep-live-cam/blob/main/modules/globals.py"
click node_capture "https://github.com/hacksider/deep-live-cam/blob/main/modules/capturer.py"
click node_video_capture "https://github.com/hacksider/deep-live-cam/blob/main/modules/video_capture.py"
click node_frame_core "https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/core.py"
click node_media_utils "https://github.com/hacksider/deep-live-cam/blob/main/modules/utilities.py"
click node_analysis "https://github.com/hacksider/deep-live-cam/blob/main/modules/face_analyser.py"
click node_mapping "https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_swapper.py"
click node_masking "https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_masking.py"
click node_enhancers "https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_enhancer.py"
click node_gpen256 "https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_enhancer_gpen256.py"
click node_gpen512 "https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_enhancer_gpen512.py"
click node_model_store "https://github.com/hacksider/deep-live-cam/tree/main/models"
click node_downloader "https://github.com/hacksider/deep-live-cam/blob/main/modules/model_downloader.py"
click node_gpu "https://github.com/hacksider/deep-live-cam/blob/main/modules/gpu_processing.py"
click node_onnx_opt "https://github.com/hacksider/deep-live-cam/blob/main/modules/onnx_optimize.py"
click node_nsfw "https://github.com/hacksider/deep-live-cam/blob/main/modules/ui.py"

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_core,node_globals,node_user toneBlue
class node_analysis,node_mapping,node_masking,node_enhancers,node_gpen256,node_gpen512 toneAmber
class node_capture,node_video_capture,node_frame_core,node_media_utils toneMint
class node_model_store,node_downloader,node_gpu,node_onnx_opt,node_nsfw toneRose
class node_camera,node_target,node_output toneIndigo
```

## Components

### Application

- [Desktop UI](https://github.com/hacksider/deep-live-cam/blob/main/modules/ui.py): `modules/ui.py`
- [App Orchestrator](https://github.com/hacksider/deep-live-cam/blob/main/modules/core.py): `modules/core.py`
- [App Settings](https://github.com/hacksider/deep-live-cam/blob/main/modules/globals.py): `modules/globals.py`

### Face Processing

- [Face Analysis](https://github.com/hacksider/deep-live-cam/blob/main/modules/face_analyser.py): `modules/face_analyser.py`
- [Face Mapping](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_swapper.py): `modules/processors/frame/face_swapper.py`
- [Face Masks](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_masking.py): `modules/processors/frame/face_masking.py`
- [Face Enhancers](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_enhancer.py): `modules/processors/frame/face_enhancer.py`
- [GPEN 256](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_enhancer_gpen256.py): `modules/processors/frame/face_enhancer_gpen256.py`
- [GPEN 512](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/face_enhancer_gpen512.py): `modules/processors/frame/face_enhancer_gpen512.py`

### Media I/O

- [Live Capture](https://github.com/hacksider/deep-live-cam/blob/main/modules/capturer.py): `modules/capturer.py`
- [Video Capture](https://github.com/hacksider/deep-live-cam/blob/main/modules/video_capture.py): `modules/video_capture.py`
- [Frame Pipeline](https://github.com/hacksider/deep-live-cam/blob/main/modules/processors/frame/core.py): `modules/processors/frame/core.py`
- [Media Utilities](https://github.com/hacksider/deep-live-cam/blob/main/modules/utilities.py): `modules/utilities.py`

### Runtime Support

- [Model Files](https://github.com/hacksider/deep-live-cam/tree/main/models): `models`
- [Model Manager](https://github.com/hacksider/deep-live-cam/blob/main/modules/model_downloader.py): `modules/model_downloader.py`
- [GPU Processing](https://github.com/hacksider/deep-live-cam/blob/main/modules/gpu_processing.py): `modules/gpu_processing.py`
- [ONNX Optimization](https://github.com/hacksider/deep-live-cam/blob/main/modules/onnx_optimize.py): `modules/onnx_optimize.py`
- [Content Check](https://github.com/hacksider/deep-live-cam/blob/main/modules/ui.py): `modules/ui.py`

### Other components

- **User**
- **Camera**
- **Target Media**
- **Output Media**

## Connections

- User → Desktop UI: configures
- Desktop UI → App Orchestrator: starts workflow
- App Orchestrator → Desktop UI: initializes
- Desktop UI → App Settings: sets options
- App Orchestrator → Frame Pipeline: dispatches processing
- Camera → Live Capture: supplies frames
- Live Capture → App Orchestrator: streams frames
- Target Media → App Orchestrator: provides media
- App Orchestrator → Video Capture: reads video
- App Orchestrator → Media Utilities: uses media operations
- Frame Pipeline → Face Analysis: requests face analysis
- Frame Pipeline → Face Mapping: dispatches swapping
- Frame Pipeline → Face Enhancers: dispatches enhancement
- Frame Pipeline → GPEN 256: dispatches enhancement
- Frame Pipeline → GPEN 512: dispatches enhancement
- Face Mapping → Face Analysis: detects faces
- Face Mapping → Face Masks: applies masks
- Face Enhancers → Face Analysis: gets faces
- Model Manager → Model Files: ensures models
- Face Enhancers → Model Manager: loads model
- Face Analysis → ONNX Optimization: optimizes model
- Face Masks → GPU Processing: uses acceleration
- Frame Pipeline → Output Media: writes processed media
- App Orchestrator → Content Check: checks target
- Desktop UI → Content Check: checks media
