# shadowcz007/comfyui-mixlab-nodes architecture

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

- Interactive diagram: https://gitdiagram.com/shadowcz007/comfyui-mixlab-nodes
- Repository: https://github.com/shadowcz007/comfyui-mixlab-nodes

## Overview

Mixlab is a ComfyUI custom-node extension for building creative workflows and publishing selected workflows as web apps. The principal path is a user configuring a ComfyUI graph, running image, prompt, media, or 3D nodes, and viewing or saving results; the web-app mode exposes configured workflow inputs and outputs in a browser. The graph includes documented capabilities whose detailed implementations were not sampled. Edges are limited to README statements and source-index references; unsampled integrations are left unconnected where their wiring is uncertain.

Main entry points: [`__init__.py`](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/__init__.py) (Node Registration), [`nodes/fish_speech/tools/llama/generate.py`](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/tools/llama/generate.py) (Speech Generation), [`nodes/fish_speech/datasets/semantic.py`](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/datasets/semantic.py) (Semantic Dataset), [`nodes/FishSpeech.py`](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/FishSpeech.py) (Fish Speech Node)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow Extension"]
  node_comfy["ComfyUI Runtime"]
  node_plugin["Node Registration<br/>[__init__.py]"]
  node_webapp["Workflow Web App<br/>[app_mixlab.js]"]
end

subgraph group_creative["Image And Prompt"]
  node_image["Image Operations<br/>[ImageNode.py]"]
  node_rembg["Background Removal<br/>[RembgNode.py]"]
  node_layers["Layer Compositing<br/>[ImageNode.py]"]
  node_prompts["Prompt Tools<br/>[PromptNode.py]"]
  node_style["Visual Styling<br/>[Style.py]"]
  node_clip["Image Interrogation"]
end

subgraph group_media["Media And 3D"]
  node_video["Video Nodes<br/>[Video.py]"]
  node_fal["Fal Video Generation<br/>[FalVideo.py]"]
  node_screen["Screen Capture<br/>[ScreenShareNode.py]"]
  node_mesh["Image To 3D<br/>[TripoSR.py]"]
  node_tsr["3D Reconstruction<br/>[system.py]"]
end

subgraph group_speech["Speech And Language"]
  node_chat["LLM Chat<br/>[ChatGPT.py]"]
  node_textgen["Text Generation"]
  node_audio["Audio Nodes<br/>[Audio.py]"]
  node_fishnode["Fish Speech Node<br/>[FishSpeech.py]"]
  node_speechdata["Semantic Dataset<br/>[semantic.py]"]
  node_speechmodel["Text Semantic Model<br/>[llama.py]"]
  node_speechgen["Speech Generation<br/>[generate.py]"]
  node_speechclean["Text Cleaning<br/>[clean.py]"]
end

subgraph group_frontend["Browser Experience"]
  node_ui["ComfyUI Frontend<br/>[ui_mixlab.js]"]
  node_frontendmain["Node UI Extensions<br/>[main_mixlab.js]"]
  node_visualizer["3D Viewer<br/>[threeVisualizer.js]"]
end

node_user(("Workflow Author"))

node_user -->|"authors workflows"| node_comfy
node_comfy -->|"loads extension"| node_plugin
node_plugin -->|"registers nodes"| node_image
node_plugin -->|"registers nodes"| node_rembg
node_plugin -->|"registers nodes"| node_prompts
node_plugin -->|"registers nodes"| node_style
node_plugin -->|"registers nodes"| node_chat
node_plugin -->|"registers nodes"| node_video
node_plugin -->|"registers nodes"| node_screen
node_plugin -->|"registers nodes"| node_mesh
node_plugin -->|"registers nodes"| node_audio
node_plugin -->|"registers nodes"| node_clip
node_plugin -->|"registers nodes"| node_textgen
node_plugin -.->|"registers nodes"| node_fishnode
node_plugin -.->|"registers nodes"| node_fal
node_plugin -.->|"adds frontend"| node_ui
node_ui -->|"loads extensions"| node_frontendmain
node_frontendmain -.->|"supports app mode"| node_webapp
node_user -->|"uses published workflow"| node_webapp
node_fishnode -.->|"uses speech model"| node_speechmodel
node_speechgen -->|"loads model"| node_speechmodel
node_speechgen -->|"cleans text"| node_speechclean
node_speechdata -->|"normalizes text"| node_speechclean
node_speechdata -->|"evaluated by"| node_speechgen
node_plugin -.->|"registers 3D nodes"| node_tsr
node_visualizer -.->|"displays 3D results"| node_mesh

click node_plugin "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/__init__.py"
click node_webapp "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/web/javascript/app_mixlab.js"
click node_image "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ImageNode.py"
click node_rembg "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/RembgNode.py"
click node_layers "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ImageNode.py"
click node_prompts "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/PromptNode.py"
click node_style "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/Style.py"
click node_clip "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ClipInterrogator.py"
click node_chat "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ChatGPT.py"
click node_textgen "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/TextGenerateNode.py"
click node_audio "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/Audio.py"
click node_fishnode "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/FishSpeech.py"
click node_speechdata "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/datasets/semantic.py"
click node_speechmodel "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/models/text2semantic/llama.py"
click node_speechgen "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/tools/llama/generate.py"
click node_speechclean "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/clean.py"
click node_video "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/Video.py"
click node_fal "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/FalVideo.py"
click node_screen "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ScreenShareNode.py"
click node_mesh "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/TripoSR.py"
click node_tsr "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/tsr/system.py"
click node_ui "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/web/javascript/ui_mixlab.js"
click node_frontendmain "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/web/javascript/main_mixlab.js"
click node_visualizer "https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/webApp/lib/threeVisualizer.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_comfy,node_plugin,node_webapp toneBlue
class node_image,node_rembg,node_layers,node_prompts,node_style,node_clip toneAmber
class node_video,node_fal,node_screen,node_mesh,node_tsr toneMint
class node_chat,node_textgen,node_audio,node_fishnode,node_speechdata,node_speechmodel,node_speechgen,node_speechclean toneRose
class node_ui,node_frontendmain,node_visualizer,node_user toneIndigo
```

## Components

### Workflow Extension

- **ComfyUI Runtime**
- [Node Registration](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/__init__.py): `__init__.py`
- [Workflow Web App](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/web/javascript/app_mixlab.js): `web/javascript/app_mixlab.js`

### Image And Prompt

- [Image Operations](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ImageNode.py): `nodes/ImageNode.py`
- [Background Removal](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/RembgNode.py): `nodes/RembgNode.py`
- [Layer Compositing](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ImageNode.py): `nodes/ImageNode.py`
- [Prompt Tools](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/PromptNode.py): `nodes/PromptNode.py`
- [Visual Styling](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/Style.py): `nodes/Style.py`
- [Image Interrogation](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ClipInterrogator.py): `nodes/ClipInterrogator.py`

### Media And 3D

- [Video Nodes](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/Video.py): `nodes/Video.py`
- [Fal Video Generation](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/FalVideo.py): `nodes/FalVideo.py`
- [Screen Capture](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ScreenShareNode.py): `nodes/ScreenShareNode.py`
- [Image To 3D](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/TripoSR.py): `nodes/TripoSR.py`
- [3D Reconstruction](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/tsr/system.py): `nodes/tsr/system.py`

### Speech And Language

- [LLM Chat](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/ChatGPT.py): `nodes/ChatGPT.py`
- [Text Generation](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/TextGenerateNode.py): `nodes/TextGenerateNode.py`
- [Audio Nodes](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/Audio.py): `nodes/Audio.py`
- [Fish Speech Node](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/FishSpeech.py): `nodes/FishSpeech.py`
- [Semantic Dataset](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/datasets/semantic.py): `nodes/fish_speech/datasets/semantic.py`
- [Text Semantic Model](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/models/text2semantic/llama.py): `nodes/fish_speech/models/text2semantic/llama.py`
- [Speech Generation](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/tools/llama/generate.py): `nodes/fish_speech/tools/llama/generate.py`
- [Text Cleaning](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/nodes/fish_speech/clean.py): `nodes/fish_speech/clean.py`

### Browser Experience

- [ComfyUI Frontend](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/web/javascript/ui_mixlab.js): `web/javascript/ui_mixlab.js`
- [Node UI Extensions](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/web/javascript/main_mixlab.js): `web/javascript/main_mixlab.js`
- [3D Viewer](https://github.com/shadowcz007/comfyui-mixlab-nodes/blob/main/webApp/lib/threeVisualizer.js): `webApp/lib/threeVisualizer.js`

### Other components

- **Workflow Author**

## Connections

- Workflow Author → ComfyUI Runtime: authors workflows (evidence: `README.md`)
- ComfyUI Runtime → Node Registration: loads extension (evidence: `README.md`)
- Node Registration → Image Operations: registers nodes (evidence: `__init__.py`)
- Node Registration → Background Removal: registers nodes (evidence: `__init__.py`)
- Node Registration → Prompt Tools: registers nodes (evidence: `__init__.py`)
- Node Registration → Visual Styling: registers nodes (evidence: `__init__.py`)
- Node Registration → LLM Chat: registers nodes (evidence: `__init__.py`)
- Node Registration → Video Nodes: registers nodes (evidence: `__init__.py`)
- Node Registration → Screen Capture: registers nodes (evidence: `__init__.py`)
- Node Registration → Image To 3D: registers nodes (evidence: `__init__.py`)
- Node Registration → Audio Nodes: registers nodes (evidence: `__init__.py`)
- Node Registration → Image Interrogation: registers nodes (evidence: `__init__.py`)
- Node Registration → Text Generation: registers nodes (evidence: `__init__.py`)
- Node Registration → Fish Speech Node: registers nodes (evidence: `__init__.py`)
- Node Registration → Fal Video Generation: registers nodes (evidence: `__init__.py`)
- Node Registration → ComfyUI Frontend: adds frontend
- ComfyUI Frontend → Node UI Extensions: loads extensions (evidence: `web/javascript/ui_mixlab.js`)
- Node UI Extensions → Workflow Web App: supports app mode
- Workflow Author → Workflow Web App: uses published workflow (evidence: `README.md`)
- Fish Speech Node → Text Semantic Model: uses speech model
- Speech Generation → Text Semantic Model: loads model (evidence: `nodes/fish_speech/tools/llama/generate.py`)
- Speech Generation → Text Cleaning: cleans text (evidence: `nodes/fish_speech/tools/llama/generate.py`)
- Semantic Dataset → Text Cleaning: normalizes text (evidence: `nodes/fish_speech/datasets/semantic.py`)
- Semantic Dataset → Speech Generation: evaluated by (evidence: `nodes/fish_speech/tools/llama/eval_in_context.py`)
- Node Registration → 3D Reconstruction: registers 3D nodes
- 3D Viewer → Image To 3D: displays 3D results
