# jeong-luke/lakis architecture

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

- Interactive diagram: https://gitdiagram.com/jeong-luke/lakis
- Repository: https://github.com/jeong-luke/lakis

## Overview

LAKIS Studio is a Windows/NVIDIA-focused external interface and curated workflow environment for ComfyUI. The main user path is configuring ANIMA or MOSS generation in the UI, then submitting a validated workflow to ComfyUI and viewing saved results. Separate branches provide custom generation nodes and installation, integrity checking, repair, and staged updates. The graph preserves README-documented features; edges between sampled modules rely on the source index, while broader product relationships cite the README.

Main entry points: [`src/external_ui/workflow_bridge.py`](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/workflow_bridge.py) (Workflow bridge), [`src/external_ui/serve_ui.py`](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/serve_ui.py) (UI server), [`src/external_ui/moss_mode.py`](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_mode.py) (MOSS engine), [`installer/LAKIS_Updater.cs`](https://github.com/jeong-luke/lakis/blob/main/installer/LAKIS_Updater.cs) (Application updater)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Studio interface"]
  node_studio["External UI<br/>[app.js]"]
  node_ui_server["UI server<br/>[serve_ui.py]"]
end

subgraph group_generation["Generation workflows"]
  node_workflow_bridge["Workflow bridge<br/>[workflow_bridge.py]"]
  node_native_workflow["Native workflow<br/>[native_workflow.py]"]
  node_moss["MOSS engine<br/>[moss_mode.py]"]
  node_moss_sampling["MOSS sampling<br/>[moss_sampling.py]"]
  node_moss_errors["MOSS diagnostics<br/>[moss_errors.py]"]
  node_scene_controls["Scene controls<br/>[scene_controls.py]"]
  node_lora["LoRA manager<br/>[lora_manager.py]"]
  node_wildcards["Wildcard service"]
end

subgraph group_extensions["ComfyUI extensions"]
  node_anima_nodes["ANIMA LLLite"]
  node_detail_nodes["Detail nodes<br/>[__init__.py]"]
  node_camera["Camera controls<br/>[camera_control.py]"]
  node_spectrum["Spectrum sampler<br/>[spectrum.py]"]
end

subgraph group_lifecycle["Install and updates"]
  node_launcher["Application launcher<br/>[LAKIS_Launcher.cs]"]
  node_setup["Setup and repair"]
  node_cmd_installer["CMD installer"]
  node_update_protocol["Update protocol<br/>[UpdateProtocol.cs]"]
  node_updater["Application updater<br/>[LAKIS_Updater.cs]"]
  node_bundle_installer["Runtime bundle"]
  node_runtime_health["Runtime integrity<br/>[runtime_health.py]"]
  node_runtime_manifest["Runtime manifest"]
  node_runtime_transition["Runtime transition"]
end

node_user(("Studio user"))
node_comfy["ComfyUI runtime"]

node_user -->|"configures"| node_studio
node_studio -.->|"uses"| node_ui_server
node_ui_server -->|"dispatches"| node_workflow_bridge
node_ui_server -->|"uses"| node_moss
node_ui_server -->|"uses"| node_lora
node_ui_server -->|"uses"| node_wildcards
node_workflow_bridge -->|"delegates to"| node_moss
node_workflow_bridge -->|"uses"| node_scene_controls
node_workflow_bridge -->|"uses"| node_lora
node_workflow_bridge -->|"uses"| node_native_workflow
node_moss -->|"uses"| node_moss_sampling
node_moss -->|"uses"| node_moss_errors
node_moss_sampling -->|"uses"| node_moss_errors
node_workflow_bridge -->|"submits workflow"| node_comfy
node_comfy -->|"executes nodes"| node_anima_nodes
node_comfy -->|"executes nodes"| node_detail_nodes
node_comfy -->|"uses controls"| node_camera
node_comfy -.->|"uses sampler"| node_spectrum
node_user -->|"launches"| node_launcher
node_launcher -->|"checks transition"| node_update_protocol
node_updater -->|"validates updates"| node_update_protocol
node_updater -->|"installs bundle"| node_bundle_installer
node_setup -->|"installs bundle"| node_bundle_installer
node_cmd_installer -->|"validates manifest"| node_runtime_manifest
node_runtime_health -->|"reads manifest"| node_runtime_manifest
node_runtime_health -.->|"checks transition"| node_runtime_transition
node_user -->|"installs or repairs"| node_setup
node_user -->|"accepts update"| node_updater

click node_studio "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/app.js"
click node_ui_server "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/serve_ui.py"
click node_workflow_bridge "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/workflow_bridge.py"
click node_native_workflow "https://github.com/jeong-luke/lakis/blob/main/src/runtime/native_workflow.py"
click node_moss "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_mode.py"
click node_moss_sampling "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_sampling.py"
click node_moss_errors "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_errors.py"
click node_scene_controls "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/scene_controls.py"
click node_lora "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/lora_manager.py"
click node_wildcards "https://github.com/jeong-luke/lakis/blob/main/src/external_ui/wildcard_service.py"
click node_anima_nodes "https://github.com/jeong-luke/lakis/blob/main/src/custom_nodes/ComfyUI-Anima-LLLite/control_net_lllite_anima.py"
click node_detail_nodes "https://github.com/jeong-luke/lakis/blob/main/src/custom_nodes/ComfyUI-LAKIS-Detail/__init__.py"
click node_camera "https://github.com/jeong-luke/lakis/blob/main/src/custom_nodes/ComfyUI-KR-Camera-Control/camera_control.py"
click node_spectrum "https://github.com/jeong-luke/lakis/blob/main/patches/ComfyUI-Spectrum-KSampler/files/spectrum.py"
click node_launcher "https://github.com/jeong-luke/lakis/blob/main/installer/LAKIS_Launcher.cs"
click node_setup "https://github.com/jeong-luke/lakis/blob/main/installer/Setup_LAKIS_Safe.cs"
click node_cmd_installer "https://github.com/jeong-luke/lakis/blob/main/installer/lakis_cmd_installer.py"
click node_update_protocol "https://github.com/jeong-luke/lakis/blob/main/installer/UpdateProtocol.cs"
click node_updater "https://github.com/jeong-luke/lakis/blob/main/installer/LAKIS_Updater.cs"
click node_bundle_installer "https://github.com/jeong-luke/lakis/blob/main/installer/RuntimeBundleInstaller.cs"
click node_runtime_health "https://github.com/jeong-luke/lakis/blob/main/installer/runtime_health.py"
click node_runtime_manifest "https://github.com/jeong-luke/lakis/blob/main/installer/runtime_manifest.py"
click node_runtime_transition "https://github.com/jeong-luke/lakis/blob/main/installer/runtime_transition.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_studio,node_ui_server,node_user,node_comfy toneBlue
class node_workflow_bridge,node_native_workflow,node_moss,node_moss_sampling,node_moss_errors,node_scene_controls,node_lora,node_wildcards toneAmber
class node_anima_nodes,node_detail_nodes,node_camera,node_spectrum toneMint
class node_launcher,node_setup,node_cmd_installer,node_update_protocol,node_updater,node_bundle_installer,node_runtime_health,node_runtime_manifest,node_runtime_transition toneRose
```

## Components

### Studio interface

- [External UI](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/app.js): `src/external_ui/app.js`
- [UI server](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/serve_ui.py): `src/external_ui/serve_ui.py`

### Generation workflows

- [Workflow bridge](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/workflow_bridge.py): `src/external_ui/workflow_bridge.py`
- [Native workflow](https://github.com/jeong-luke/lakis/blob/main/src/runtime/native_workflow.py): `src/runtime/native_workflow.py`
- [MOSS engine](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_mode.py): `src/external_ui/moss_mode.py`
- [MOSS sampling](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_sampling.py): `src/external_ui/moss_sampling.py`
- [MOSS diagnostics](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/moss_errors.py): `src/external_ui/moss_errors.py`
- [Scene controls](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/scene_controls.py): `src/external_ui/scene_controls.py`
- [LoRA manager](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/lora_manager.py): `src/external_ui/lora_manager.py`
- [Wildcard service](https://github.com/jeong-luke/lakis/blob/main/src/external_ui/wildcard_service.py): `src/external_ui/wildcard_service.py`

### ComfyUI extensions

- [ANIMA LLLite](https://github.com/jeong-luke/lakis/blob/main/src/custom_nodes/ComfyUI-Anima-LLLite/control_net_lllite_anima.py): `src/custom_nodes/ComfyUI-Anima-LLLite/control_net_lllite_anima.py`
- [Detail nodes](https://github.com/jeong-luke/lakis/blob/main/src/custom_nodes/ComfyUI-LAKIS-Detail/__init__.py): `src/custom_nodes/ComfyUI-LAKIS-Detail/__init__.py`
- [Camera controls](https://github.com/jeong-luke/lakis/blob/main/src/custom_nodes/ComfyUI-KR-Camera-Control/camera_control.py): `src/custom_nodes/ComfyUI-KR-Camera-Control/camera_control.py`
- [Spectrum sampler](https://github.com/jeong-luke/lakis/blob/main/patches/ComfyUI-Spectrum-KSampler/files/spectrum.py): `patches/ComfyUI-Spectrum-KSampler/files/spectrum.py`

### Install and updates

- [Application launcher](https://github.com/jeong-luke/lakis/blob/main/installer/LAKIS_Launcher.cs): `installer/LAKIS_Launcher.cs`
- [Setup and repair](https://github.com/jeong-luke/lakis/blob/main/installer/Setup_LAKIS_Safe.cs): `installer/Setup_LAKIS_Safe.cs`
- [CMD installer](https://github.com/jeong-luke/lakis/blob/main/installer/lakis_cmd_installer.py): `installer/lakis_cmd_installer.py`
- [Update protocol](https://github.com/jeong-luke/lakis/blob/main/installer/UpdateProtocol.cs): `installer/UpdateProtocol.cs`
- [Application updater](https://github.com/jeong-luke/lakis/blob/main/installer/LAKIS_Updater.cs): `installer/LAKIS_Updater.cs`
- [Runtime bundle](https://github.com/jeong-luke/lakis/blob/main/installer/RuntimeBundleInstaller.cs): `installer/RuntimeBundleInstaller.cs`
- [Runtime integrity](https://github.com/jeong-luke/lakis/blob/main/installer/runtime_health.py): `installer/runtime_health.py`
- [Runtime manifest](https://github.com/jeong-luke/lakis/blob/main/installer/runtime_manifest.py): `installer/runtime_manifest.py`
- [Runtime transition](https://github.com/jeong-luke/lakis/blob/main/installer/runtime_transition.py): `installer/runtime_transition.py`

### Other components

- **Studio user**
- **ComfyUI runtime**

## Connections

- Studio user → External UI: configures (evidence: `README.md`)
- External UI → UI server: uses
- UI server → Workflow bridge: dispatches (evidence: `src/external_ui/serve_ui.py`)
- UI server → MOSS engine: uses (evidence: `src/external_ui/serve_ui.py`)
- UI server → LoRA manager: uses (evidence: `src/external_ui/serve_ui.py`)
- UI server → Wildcard service: uses (evidence: `src/external_ui/serve_ui.py`)
- Workflow bridge → MOSS engine: delegates to (evidence: `src/external_ui/workflow_bridge.py`)
- Workflow bridge → Scene controls: uses (evidence: `src/external_ui/workflow_bridge.py`)
- Workflow bridge → LoRA manager: uses (evidence: `src/external_ui/workflow_bridge.py`)
- Workflow bridge → Native workflow: uses (evidence: `src/external_ui/workflow_bridge.py`)
- MOSS engine → MOSS sampling: uses (evidence: `src/external_ui/moss_mode.py`)
- MOSS engine → MOSS diagnostics: uses (evidence: `src/external_ui/moss_mode.py`)
- MOSS sampling → MOSS diagnostics: uses (evidence: `src/external_ui/moss_sampling.py`)
- Workflow bridge → ComfyUI runtime: submits workflow (evidence: `README.md`)
- ComfyUI runtime → ANIMA LLLite: executes nodes (evidence: `README.md`)
- ComfyUI runtime → Detail nodes: executes nodes (evidence: `README.md`)
- ComfyUI runtime → Camera controls: uses controls (evidence: `README.md`)
- ComfyUI runtime → Spectrum sampler: uses sampler
- Studio user → Application launcher: launches (evidence: `README.md`)
- Application launcher → Update protocol: checks transition (evidence: `installer/LAKIS_Launcher.cs`)
- Application updater → Update protocol: validates updates (evidence: `installer/LAKIS_Updater.cs`)
- Application updater → Runtime bundle: installs bundle (evidence: `installer/LAKIS_Updater.cs`)
- Setup and repair → Runtime bundle: installs bundle (evidence: `installer/Setup_LAKIS_Safe.cs`)
- CMD installer → Runtime manifest: validates manifest (evidence: `installer/lakis_cmd_installer.py`)
- Runtime integrity → Runtime manifest: reads manifest (evidence: `installer/runtime_health.py`)
- Runtime integrity → Runtime transition: checks transition
- Studio user → Setup and repair: installs or repairs (evidence: `README.md`)
- Studio user → Application updater: accepts update (evidence: `README.md`)