comfyui-darkil-nodes

Custom ComfyUI Nodes

Languages: English · Русский

This repository contains custom nodes for ComfyUI that extend functionality for workflows.

Available Nodes

Text Processing Nodes

1. Variable builder [darkilNodes]

• Category: darkilNodes/text
• Description: Builds text variables from multiple inputs with configurable formatting.
• Features:
  • Supports multiple input types (text, integers, floats)
  • Configurable separators and prefixes/suffixes
  • Conditional output based on input presence
• Inputs:
  • switch (BOOL): node active toggle
  • out_val_by_switch (BOOL): return if active
  • var_name (STRING): variable name
  • var_value (STRING): variable value
  • INPUT_VAR (STRING): other variables input

2. Advanced variable builder [darkilNodes]

• Category: darkilNodes/text
• Description: Advanced text variable builder with complex formatting options.
• Features:
  • Supports multiple input types with custom formatting
  • Configurable separators and prefixes/suffixes
  • Conditional output based on input presence
  • Customizable number formatting for integers and floats
• Inputs:
  • switch (BOOL): node active toggle
  • out_val_by_switch (BOOL): return if active
  • var_name (STRING): variable name
  • var_text (STRING): variable value
  • INPUT_VAR (STRING): other variables input
  • DYNAMIC_* (STRING): dynamic inputs
  • condition (BOOLEAN): When True, outputs only if inputs are present
  • int_format (STRING): Format string for integers
  • float_format (STRING): Format string for floats

3. Dynamic prompt builder [darkilNodes]

• Category: darkilNodes/text
• Description: Builds prompts from a small template language. Placeholders and toggle tags written in the prompt text spawn matching widgets on the node, so one prompt can be reconfigured live without editing the text.
• Features:
  • Placeholders {{NAME:TYPE:VALUE:DEFAULT:USE_INPUT}} create dynamic widgets. TYPE = STRING, INT, FLOAT, COMBO, SLIDER, KNOB; USE_INPUT (true) exposes an input socket for the value.
  • Toggle tags [[TAG]]…[[/TAG]] keep or drop the wrapped block via a per-tag switch. [[TAG:GROUP]] makes tags sharing a GROUP mutually exclusive (radio behavior). Tags can be nested.
  • Extra block [%extra%]…[%/extra%] is compiled to a second output; Vars block [%vars%]…[%/vars%] is ignored by the backend (a notes/scratch area).
  • Comments removed before processing: // …, # …, /* … */.
  • Spaceless blocks {%spaceless%}…{%spaceless stop%} collapse whitespace, and formatting directives (lower, upper, title, sentence, trim, dedent, list, list_and, …) transform the wrapped text and can be nested.
  • Syntax-highlighting editor: color highlighting, an Insert / Vars menu, caret-context hints, validation underlines, and keyboard autocomplete (EN/RU localized).
  • Compact switch bar: three inline switches on one row — EDITOR (show/hide the editor), PROMPT (process the main prompt), EXTRA (process the extra block).
• Inputs:
  • prompt (STRING, multiline): the prompt template with placeholders, tags, blocks and directives
• UI switches (client-side, one compact row):
  • EDITOR: show/hide the prompt editor widget
  • PROMPT: enable/disable processing of the main prompt (compiled_prompt)
  • EXTRA: enable/disable processing of the extra block (extra_compiled)
• Outputs:
  • compiled_prompt (STRING): the processed main prompt (empty when PROMPT is off)
  • extra_compiled (STRING): the processed extra block (empty when absent or EXTRA is off)

4. Text is empty [darkilNodes]

• Category: darkilNodes/text
• Description: Checks if a text string is empty or contains only whitespace.
• Inputs:
  • text (STRING): The text to check
• Outputs:
  • BOOLEAN: True if the text is empty, False otherwise

5. Text not empty [darkilNodes]

• Category: darkilNodes/text
• Description: Checks if a text string contains content.
• Inputs:
  • text (STRING): The text to check
• Outputs:
  • BOOLEAN: True if the text is not empty, False otherwise

6. Text lines count [darkilNodes]

• Category: darkilNodes/text
• Description: Counts the number of lines in a text string.
• Inputs:
  • text (STRING): The text to count lines for
• Outputs:
  • INT: Number of lines in the text

7. Strings Joiner [darkilNodes]

• Category: darkilNodes/text
• Description: Joins multiple text inputs with a specified separator.
• Features:
  • Supports dynamic number of text inputs via DYNAMIC_* slots
  • Escape sequence support (\n for newline, \t for tab)
  • Filters empty/None values before joining
• Inputs:
  • joiner: Separator string used to join texts (supports escape sequences)
  • DYNAMIC_*: Dynamic text inputs to join
• Outputs:
  • joined_text: Combined text with joiner as separator

Logic Nodes

1. Multi toggles [darkilNodes]

• Category: darkilNodes/logic
• Description: Provides multiple toggle switches for selecting options.
• Features:
  • Configurable via node properties
  • Supports radio button behavior
  • Customizable delimiter and last word for string joining
• UI Configuration Properties:
  • text_for_toggles: Defines toggle options (semicolon or pipe separated)
  • is_radio_toggles: Enables radio button behavior
  • trim_values: Trims whitespace from values
  • last_word: Custom word before final item in joined string
  • delimiter: String used to join items

2. Custom combo box [darkilNodes]

• Category: darkilNodes/logic
• Description: Allows selection from a custom combo list.
• Features:
  • Configurable via node properties
  • Supports semicolon or pipe separated items
  • Outputs selected value and help text
• UI Configuration Properties:
  • text_for_combo: List of items (semicolon or pipe separated)

3. Diffusion Model Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the diffusion model into memory later in the workflow chain.
• Features:
  • Allows connecting the loader of the model along the chain
  • Allows clearing the model cache
  • Allows unloading models from memory
• Inputs:
  • any_trigger: Any type as a trigger for loading the diffusion model
  • unet_name: Name of the diffusion model to load
  • weight_dtype: Weight data type (default, fp8_e4m3fn, fp8_e4m3fn_fast, fp8_e5m2)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

4. CLIP Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the CLIP model into memory later in the workflow chain.
• Features:
  • Allows connecting the CLIP loader along the execution chain
  • Supports memory cleanup options
• Inputs:
  • any_trigger: Any type as a trigger for loading the CLIP model
  • Standard CLIP loader inputs (clip_name, type)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

5. DualCLIP Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the DualCLIP model into memory later in the workflow chain.
• Features:
  • Allows connecting the DualCLIP loader along the execution chain
  • Supports memory cleanup options
• Inputs:
  • any_trigger: Any type as a trigger for loading the DualCLIP model
  • Standard DualCLIP loader inputs (clip_name1, clip_name2, type)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

6. VAE Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the VAE model into memory later in the workflow chain.
• Features:
  • Allows connecting the VAE loader along the execution chain
  • Supports memory cleanup options
• Inputs:
  • any_trigger: Any type as a trigger for loading the VAE model
  • Standard VAE loader input (vae_name)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

7. Multi Set [darkilNodes]

• Category: darkilNodes/logic
• Description: Creates a named group that dynamically generates matching input and output slots.
• Features:
  • Define a group name via widget; the name is kept unique across the graph.
  • When an input slot is connected, the node automatically creates a corresponding output slot with matching type and a generated name (<type>_<index>).
  • Supports a wildcard placeholder pair that is always kept free for further connections; extra placeholders are removed automatically.
  • Works with both native Multi Set nodes and KJNodes SetNode (compatibility mode).
  • Propagates color changes to linked Get nodes.
  • Virtual node – does not affect prompt serialization.

8. Multi Get [darkilNodes]

• Category: darkilNodes/logic
• Description: Reads a group created by a Multi Set node and generates matching output slots dynamically.
• Features:
  • Group selector combo box populated with all existing Multi Set groups in the current graph.
  • Automatically rebuilds its outputs to mirror the inputs of the associated Multi Set node (type, order, naming).
  • Preserves existing connections when the group changes or when slots are added/removed.
  • Validates links to avoid type mismatches.
  • Synchronizes node colour with its corresponding Multi Set node.

9. Multi Get AIO [darkilNodes]

• Category: darkilNodes/logic
• Description: An "All-In-One" version of Multi Get that can pull data from multiple groups at once.
• Features:
  • Widget to set the number of groups (1–100) and a combo box for each group to select an existing Multi Set group.
  • Generates output slots for every input of every selected group, naming them as <type>_<index> [ <group_index> ].
  • Maintains connections across re-configuration by mapping old outputs to new ones based on group name and original input index.
  • Supports colour inheritance from each source Multi Set node.
  • Validates and cleans up broken links automatically.
  • Virtual node – does not affect prompt serialization.

Multi Set / Multi Get / Multi Get AIO (web/js/multi_set_get.js) are derived from ComfyUI-KJNodes (© kijai and contributors) and, unlike the rest of this MIT-licensed package, are licensed under GPL-3.0. See web/js/LICENSE.GPL-3.0.txt.

10. Constant setter [darkilNodes]

• Category: darkilNodes/logic
• Description: Sets a constant value of various types for use in workflows.
• Features:
  • Supports multiple data types: STRING, INT, FLOAT, BOOLEAN, COMBO
  • Slider/Knob controls with configurable min/max ranges
  • Type conversion from input values
  • Virtual node – does not affect prompt serialization
• UI Configuration Properties:
  • const_type: Data type (STRING, INT, FLOAT (FLOAT2-FLOAT5), BOOLEAN, COMBO, SLIDER (SLIDER2-SLIDER5), KNOB (KNOB2-KNOB5))
  • default_value: Default constant value
  • minimum, maximum: Range bounds for numeric types
  • values: Semicolon-separated list for COMBO type
  • input_enable: Enable input slot for value conversion

WAN Nodes

1. I2V Encode with Middle Frame [darkilNodes]

• Category: darkilNodes/wan
• Description: Clone of WanVideoWrapper's 'WanVideo ImageToVideo Encode' with added middle frame support. Built from code of other custom node projects.
• Features:
  • Accepts start_image, middle_image (optional), and end_image (optional)
  • middle_frame_ratio controls the position of the middle frame (0.0 = start, 1.0 = end)
  • middle_latent_strength controls the conditioning strength of the middle frame in latent space
  • motion_amplitude (>1.0) enhances inter-frame motion
  • Supports noise augmentation, tiled VAE encoding, and empty frame padding
• Based on:
  • ComfyUI-Wan22FMLF
  • ComfyUI-PainterI2VforKJ
  • ComfyUI-WanVideoWrapper
• Inputs:
  • width, height, num_frames
  • noise_aug_strength, start_latent_strength, end_latent_strength, middle_latent_strength
  • middle_frame_ratio, motion_amplitude, force_offload
  • vae (WANVAE)
  • start_image, middle_image, end_image
  • clip_embeds, control_embeds, temporal_mask, extra_latents
  • tiled_vae, fun_or_fl2v_model, augment_empty_frames, empty_frame_pad_image
• Outputs:
  • image_embeds (WANVIDIMAGE_EMBEDS)

2. LoRA list for WanVideoWrapper by Kijai [darkilNodes]

• Category: darkilNodes/wan
• Description: Parses textual lists of LoRA definitions for WanVideoWrapper nodes by Kijai.
• Features:
  • Supports multiple input formats (newlines, semicolons, pipes)
  • Handles comments (both line and block style)
  • Low/high noise model targeting with prefixes
  • Block selection support
  • Merging of LoRAs for efficiency
  • Previous list merging capability
• Input Format:
  • <LoRA name>[:<strength>]
  • Prefixes: l<<, l<, <low:, low: for low-noise model, h<<, h<, <high:, high: for high-noise model
• Special Features:
  • Supports block comments /* ... */ and line comments // ...
  • Optional merging of multiple LoRAs into a single tensor
  • Low-memory loading option
  • Automatic handling of missing files with error logging

Conditioning Nodes

1. Krea2 Rebalance Equalizer [darkilNodes]

• Category: darkilNodes/conditioning
• Description: Per-layer conditioning scaler for the Krea 2 (Qwen3-VL-4B, 12-layer tap) layout. Adjust the gain of each model tap layer with a built-in equalizer, then scale the whole conditioning by a multiplier.
• Features:
  • Horizontal equalizer with 12 vertical faders, one per Krea 2 tap layer (labeled 2, 5, 8, … 35), range −2.0 … 10.0
  • multiplier rendered as a matching horizontal slider (−10.0 … 10.0)
  • "Reset to defaults" button
  • Presets: save the current profile (multiplier + 12 weights) under a name, load it from a combo box, delete with the red ✖. Presets are stored server-side in nodes/conditioning/krea2_eq_presets.json (shared across browsers/workflows on the machine; no extra port — served by the existing ComfyUI server)
  • Fully custom-drawn UI with no external JS dependencies
• Inputs:
  • conditioning (CONDITIONING): the conditioning to rescale
  • multiplier (FLOAT): global scale applied to the whole conditioning
• Outputs:
  • conditioning (CONDITIONING): the rescaled conditioning
• Based on:
  • ComfyUI-Conditioning-Rebalance (Apache-2.0) — vendored scaling helpers, see nodes/conditioning/THIRD_PARTY_LICENSES.txt

File Handling Nodes

1. Files list from dir [darkilNodes]

• Category: darkilNodes/files
• Description: Lists files in a directory based on extension and sorting criteria.
• Features:
  • Supports glob patterns for file filtering
  • Multiple sorting options (by date, name, size)
  • Recursive subdirectory search capability
  • Configurable output format (with/without extensions, full paths)
• Inputs:
  • folder_path (STRING): Path to the directory to scan
  • files_extension (STRING): Extension filter; can be a simple extension (e.g., "png") or any glob pattern (e.g., "*.txt")
  • sort_by (COMBO): Sorting method – by date, name, size and their descending variants
  • sub_foldres (BOOLEAN): If true, search recursively in sub-folders
  • keep_extensions (BOOLEAN): Keep file extensions in the output names
  • keep_full_path (BOOLEAN): Return full absolute paths instead of just filenames
• Outputs:
  • found_list (STRING): List of file names/paths
  • found_as_text (STRING): Newline-separated string of all files
  • last_filename (STRING): Name/path of the last file after sorting
  • first_filename (STRING): Name/path of the first file after sorting
  • files_count (INT): Total number of files found

Installation

1. Clone or download this repository into your ComfyUI custom_nodes folder:

   cd ComfyUI/custom_nodes
   git clone https://github.com/pytraveler/comfyui-darkil-nodes.git
   

2. Restart ComfyUI to load the new nodes.

Usage Examples

LoRA Management Example

Wan22VideoLoraListBuilder → WanVideoSetLoRAs (Kijai)

License

MIT License for the package as a whole — see the LICENSE file for details.

Component exceptions (derivative works under their upstream licenses):

• web/js/multi_set_get.js (Multi Set / Multi Get / Multi Get AIO) is licensed under GPL-3.0, derived from ComfyUI-KJNodes (© kijai and contributors). Full text: web/js/LICENSE.GPL-3.0.txt.
• nodes/conditioning/rebalance_core.py — Apache-2.0, see nodes/conditioning/THIRD_PARTY_LICENSES.txt.
• nodes/wan/i2v_encode_middle.py — adapts Apache-2.0 code from WanVideoWrapper and related projects (see the node's "Based on" list above).

See the "Component licenses" section of the LICENSE file for the full list.