# nekodificador/comfyui-nkd-basic-tools architecture

> Architecture diagram of the GitHub repository nekodificador/comfyui-nkd-basic-tools, 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/nekodificador/comfyui-nkd-basic-tools
- Repository: https://github.com/nekodificador/comfyui-nkd-basic-tools

## Overview

NKD Basic Tools is a ComfyUI custom-node pack for image, mask, face, color, blur, texture, and prompt workflows. A user wires inputs into a node, adjusts parameters (often with an in-node preview), and receives transformed images, masks, or text for downstream graph nodes. The map preserves the README’s major capability areas; it is a capability map rather than a complete call graph, since most node implementations were not excerpted. Face Rig’s editor-to-render route and selected frontend bindings are shown where source evidence supports them.

Main entry points: [`src/main.ts`](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/main.ts) (ComfyUI editor bindings), [`nkd_face_rig_engine.py`](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig_engine.py) (LivePortrait engine), [`nkd_face_core.py`](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_core.py) (Face detection), [`nkd_face_rig_routes.py`](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig_routes.py) (Rig preview routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_image_mask["Image &amp; masks"]
  node_crop_stitch["Crop / stitch<br/>[nkd_crop_stitch.py]"]
  node_crop_outpaint["Crop / outpaint<br/>[nkd_crop.py]"]
  node_mask_ops["Mask operations<br/>[nkd_mask_ops.py]"]
  node_mask_painter["Mask painter"]
  node_vector_mask["Vector mask<br/>[nkd_vector_mask.py]"]
  node_paint["Paint canvas<br/>[nkd_paint.py]"]
  node_frequency["Frequency separation<br/>[nkd_frequency.py]"]
end

subgraph group_face["Face tools"]
  node_face_crop["Face crop / stitch<br/>[nkd_face_crop.py]"]
  node_face_core["Face detection<br/>[nkd_face_core.py]"]
  node_face_rig["Face rig node<br/>[nkd_face_rig.py]"]
  node_face_routes["Rig preview routes"]
  node_face_engine["LivePortrait engine"]
  node_liveportrait_models["LivePortrait networks"]
  node_face_cropper["Face alignment crop<br/>[crop.py]"]
end

subgraph group_color["Color &amp; blur"]
  node_color_warp["Color warp<br/>[nkd_color_warp.py]"]
  node_color_mesh["Color mesh / LUT<br/>[mesh.py]"]
  node_gradient["Gradient tools"]
  node_gradient_map["Gradient map"]
  node_path_blur["Path blur<br/>[nkd_path_blur.py]"]
  node_field_blur["Field blur<br/>[nkd_field_blur.py]"]
end

subgraph group_media["Media &amp; texture"]
  node_film_grain["Film grain<br/>[nkd_film_grain.py]"]
  node_noise["Procedural noise<br/>[nkd_noise.py]"]
  node_av_latent["Audio-video latent<br/>[nkd_av_latent.py]"]
  node_minimax["MiniMax guides"]
  node_lora["LoRA control"]
  node_string_split["String split"]
  node_prompt_vars["Prompt variables"]
  node_resolution["Resolution selector<br/>[nkd_resolution.py]"]
end

subgraph group_ui["Node editors"]
  node_frontend["ComfyUI editor bindings<br/>[main.ts]"]
  node_face_editor["Face rig editor<br/>[faceRig.ts]"]
  node_color_viewer["Color warp viewer<br/>[colorWarpViewer.ts]"]
  node_gradient_widget["Gradient preview"]
  node_prompt_widget["Prompt editor"]
end

node_user(("ComfyUI user"))

node_user -->|"runs node"| node_crop_stitch
node_user -->|"runs node"| node_crop_outpaint
node_user -->|"runs node"| node_mask_ops
node_user -->|"paints mask"| node_mask_painter
node_user -->|"draws mask"| node_vector_mask
node_user -->|"paints guide"| node_paint
node_user -->|"runs node"| node_face_crop
node_user -->|"poses face"| node_face_rig
node_user -->|"separates detail"| node_frequency
node_user -->|"grades image"| node_color_warp
node_user -->|"creates gradient"| node_gradient
node_user -->|"maps gradient"| node_gradient_map
node_user -->|"draws blur path"| node_path_blur
node_user -->|"sets blur pins"| node_field_blur
node_user -->|"adds grain"| node_film_grain
node_user -->|"creates noise"| node_noise
node_user -->|"runs node"| node_av_latent
node_user -->|"runs node"| node_minimax
node_user -->|"controls LoRA"| node_lora
node_user -->|"splits prompts"| node_string_split
node_user -->|"edits prompt"| node_prompt_vars
node_user -->|"sets dimensions"| node_resolution
node_frontend -->|"mounts editor"| node_prompt_widget
node_frontend -->|"mounts preview"| node_gradient_widget
node_frontend -->|"registers editor"| node_face_editor
node_frontend -->|"opens viewer"| node_color_viewer
node_face_editor -.->|"posts preview"| node_face_routes
node_face_routes -->|"renders pose"| node_face_engine
node_face_engine -->|"uses landmarks"| node_face_core
node_face_engine -->|"runs networks"| node_liveportrait_models
node_face_core -->|"uses alignment"| node_face_cropper
node_color_viewer -.->|"bakes LUT"| node_color_mesh

click node_crop_stitch "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_crop_stitch.py"
click node_crop_outpaint "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_crop.py"
click node_mask_ops "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_mask_ops.py"
click node_mask_painter "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_mask_painter.py"
click node_vector_mask "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_vector_mask.py"
click node_paint "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_paint.py"
click node_face_crop "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_crop.py"
click node_face_core "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_core.py"
click node_face_rig "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig.py"
click node_face_routes "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig_routes.py"
click node_face_engine "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig_engine.py"
click node_liveportrait_models "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_liveportrait/modules/appearance_feature_extractor.py"
click node_face_cropper "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_liveportrait/utils/crop.py"
click node_frequency "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_frequency.py"
click node_color_warp "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_color_warp.py"
click node_color_mesh "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/color_core/mesh.py"
click node_gradient "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_gradient_generate.py"
click node_gradient_map "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_gradient_map.py"
click node_path_blur "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_path_blur.py"
click node_field_blur "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_field_blur.py"
click node_film_grain "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_film_grain.py"
click node_noise "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_noise.py"
click node_av_latent "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_av_latent.py"
click node_minimax "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_minimax_guides.py"
click node_lora "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_lora_control.py"
click node_string_split "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_string_split.py"
click node_prompt_vars "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_prompt_variables.py"
click node_resolution "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_resolution.py"
click node_frontend "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/main.ts"
click node_face_editor "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/faceRig.ts"
click node_color_viewer "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/colorWarpViewer.ts"
click node_gradient_widget "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/GradientPreviewWidget.vue"
click node_prompt_widget "https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/PromptVariablesWidget.vue"

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_crop_stitch,node_crop_outpaint,node_mask_ops,node_mask_painter,node_vector_mask,node_paint,node_frequency,node_user toneBlue
class node_face_crop,node_face_core,node_face_rig,node_face_routes,node_face_engine,node_liveportrait_models,node_face_cropper toneAmber
class node_color_warp,node_color_mesh,node_gradient,node_gradient_map,node_path_blur,node_field_blur toneMint
class node_film_grain,node_noise,node_av_latent,node_minimax,node_lora,node_string_split,node_prompt_vars,node_resolution toneRose
class node_frontend,node_face_editor,node_color_viewer,node_gradient_widget,node_prompt_widget toneIndigo
```

## Components

### Image & masks

- [Crop / stitch](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_crop_stitch.py): `nkd_crop_stitch.py`
- [Crop / outpaint](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_crop.py): `nkd_crop.py`
- [Mask operations](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_mask_ops.py): `nkd_mask_ops.py`
- [Mask painter](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_mask_painter.py): `nkd_mask_painter.py`
- [Vector mask](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_vector_mask.py): `nkd_vector_mask.py`
- [Paint canvas](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_paint.py): `nkd_paint.py`
- [Frequency separation](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_frequency.py): `nkd_frequency.py`

### Face tools

- [Face crop / stitch](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_crop.py): `nkd_face_crop.py`
- [Face detection](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_core.py): `nkd_face_core.py`
- [Face rig node](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig.py): `nkd_face_rig.py`
- [Rig preview routes](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig_routes.py): `nkd_face_rig_routes.py`
- [LivePortrait engine](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_face_rig_engine.py): `nkd_face_rig_engine.py`
- [LivePortrait networks](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_liveportrait/modules/appearance_feature_extractor.py): `nkd_liveportrait/modules/appearance_feature_extractor.py`
- [Face alignment crop](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_liveportrait/utils/crop.py): `nkd_liveportrait/utils/crop.py`

### Color & blur

- [Color warp](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_color_warp.py): `nkd_color_warp.py`
- [Color mesh / LUT](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/color_core/mesh.py): `color_core/mesh.py`
- [Gradient tools](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_gradient_generate.py): `nkd_gradient_generate.py`
- [Gradient map](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_gradient_map.py): `nkd_gradient_map.py`
- [Path blur](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_path_blur.py): `nkd_path_blur.py`
- [Field blur](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_field_blur.py): `nkd_field_blur.py`

### Media & texture

- [Film grain](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_film_grain.py): `nkd_film_grain.py`
- [Procedural noise](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_noise.py): `nkd_noise.py`
- [Audio-video latent](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_av_latent.py): `nkd_av_latent.py`
- [MiniMax guides](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_minimax_guides.py): `nkd_minimax_guides.py`
- [LoRA control](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_lora_control.py): `nkd_lora_control.py`
- [String split](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_string_split.py): `nkd_string_split.py`
- [Prompt variables](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_prompt_variables.py): `nkd_prompt_variables.py`
- [Resolution selector](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/nkd_resolution.py): `nkd_resolution.py`

### Node editors

- [ComfyUI editor bindings](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/main.ts): `src/main.ts`
- [Face rig editor](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/faceRig.ts): `src/faceRig.ts`
- [Color warp viewer](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/colorWarpViewer.ts): `src/colorWarpViewer.ts`
- [Gradient preview](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/GradientPreviewWidget.vue): `src/GradientPreviewWidget.vue`
- [Prompt editor](https://github.com/nekodificador/comfyui-nkd-basic-tools/blob/master/src/PromptVariablesWidget.vue): `src/PromptVariablesWidget.vue`

### Other components

- **ComfyUI user**

## Connections

- ComfyUI user → Crop / stitch: runs node
- ComfyUI user → Crop / outpaint: runs node
- ComfyUI user → Mask operations: runs node
- ComfyUI user → Mask painter: paints mask
- ComfyUI user → Vector mask: draws mask
- ComfyUI user → Paint canvas: paints guide
- ComfyUI user → Face crop / stitch: runs node
- ComfyUI user → Face rig node: poses face
- ComfyUI user → Frequency separation: separates detail
- ComfyUI user → Color warp: grades image
- ComfyUI user → Gradient tools: creates gradient
- ComfyUI user → Gradient map: maps gradient
- ComfyUI user → Path blur: draws blur path
- ComfyUI user → Field blur: sets blur pins
- ComfyUI user → Film grain: adds grain
- ComfyUI user → Procedural noise: creates noise
- ComfyUI user → Audio-video latent: runs node
- ComfyUI user → MiniMax guides: runs node
- ComfyUI user → LoRA control: controls LoRA
- ComfyUI user → String split: splits prompts
- ComfyUI user → Prompt variables: edits prompt
- ComfyUI user → Resolution selector: sets dimensions
- ComfyUI editor bindings → Prompt editor: mounts editor (evidence: `src/main.ts`)
- ComfyUI editor bindings → Gradient preview: mounts preview (evidence: `src/main.ts`)
- ComfyUI editor bindings → Face rig editor: registers editor (evidence: `src/main.ts`)
- ComfyUI editor bindings → Color warp viewer: opens viewer (evidence: `src/main.ts`)
- Face rig editor → Rig preview routes: posts preview
- Rig preview routes → LivePortrait engine: renders pose (evidence: `nkd_face_rig_routes.py`)
- LivePortrait engine → Face detection: uses landmarks (evidence: `nkd_face_rig_engine.py`)
- LivePortrait engine → LivePortrait networks: runs networks (evidence: `nkd_face_rig_engine.py`)
- Face detection → Face alignment crop: uses alignment (evidence: `nkd_face_core.py`)
- Color warp viewer → Color mesh / LUT: bakes LUT
