How nekodificador/comfyui-nkd-basic-tools works
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: main.ts ComfyUI editor bindings · nkd_face_rig_engine.py LivePortrait engine · nkd_face_core.py Face detection · nkd_face_rig_routes.py Rig preview routes
Components 34
Image & masks
- Crop / stitch
nkd_crop_stitch.py - Crop / outpaint
nkd_crop.py - Mask operations
nkd_mask_ops.py - Mask painter
nkd_mask_painter.py - Vector mask
nkd_vector_mask.py - Paint canvas
nkd_paint.py - Frequency separation
nkd_frequency.py
Face tools
- Face crop / stitch
nkd_face_crop.py - Face detection
nkd_face_core.py - Face rig node
nkd_face_rig.py - Rig preview routes
nkd_face_rig_routes.py - LivePortrait engine
nkd_face_rig_engine.py - LivePortrait networks
nkd_liveportrait/modules/appearance_feature_extractor.py - Face alignment crop
nkd_liveportrait/utils/crop.py
Color & blur
- Color warp
nkd_color_warp.py - Color mesh / LUT
color_core/mesh.py - Gradient tools
nkd_gradient_generate.py - Gradient map
nkd_gradient_map.py - Path blur
nkd_path_blur.py - Field blur
nkd_field_blur.py
Media & texture
- Film grain
nkd_film_grain.py - Procedural noise
nkd_noise.py - Audio-video latent
nkd_av_latent.py - MiniMax guides
nkd_minimax_guides.py - LoRA control
nkd_lora_control.py - String split
nkd_string_split.py - Prompt variables
nkd_prompt_variables.py - Resolution selector
nkd_resolution.py
Node editors
- ComfyUI editor bindings
src/main.ts - Face rig editor
src/faceRig.ts - Color warp viewer
src/colorWarpViewer.ts - Gradient preview
src/GradientPreviewWidget.vue - Prompt editor
src/PromptVariablesWidget.vue
Other components
- ComfyUI user
Connections 32
- 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
src/main.ts - ComfyUI editor bindings → Gradient preview: mounts preview
src/main.ts - ComfyUI editor bindings → Face rig editor: registers editor
src/main.ts - ComfyUI editor bindings → Color warp viewer: opens viewer
src/main.ts - Face rig editor → Rig preview routes: posts preview
- Rig preview routes → LivePortrait engine: renders pose
nkd_face_rig_routes.py - LivePortrait engine → Face detection: uses landmarks
nkd_face_rig_engine.py - LivePortrait engine → LivePortrait networks: runs networks
nkd_face_rig_engine.py - Face detection → Face alignment crop: uses alignment
nkd_face_core.py - Color warp viewer → Color mesh / LUT: bakes LUT