# Custom ComfyUI Nodes Languages: **English** · [Русский](README_RU.MD) This repository contains custom nodes for ComfyUI that extend functionality for workflows. ## Available Nodes ### Text Processing Nodes #### 1. Variable builder [darkilNodes] ![Variable builder](docs/images/node_var_build.png) - **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] ![Advanced variable builder](docs/images/node_adv_var_build.png) - **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] ![Dynamic prompt builder 1](docs/images/node_prompt_build_1.png) ![Dynamic prompt builder 2](docs/images/node_prompt_build_2.png) - **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] ![Text is empty](docs/images/node_text_is_empty.png) - **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] ![Text not empty](docs/images/node_text_not_empty.png) - **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] ![Text lines count](docs/images/node_lines_count.png) - **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] ![Strings Joiner](docs/images/node_str_joiner.png) - **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] ![Multi toggles 1](docs/images/node_multi_toggle_1.png) ![Multi toggles 2](docs/images/node_multi_toggle_2.png) - **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] ![Custom combo box 1](docs/images/node_combo_1.png) ![Custom combo box 2](docs/images/node_combo_2.png) - **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] ![Diffusion model loader later](docs/images/node_diff_model_later.png) - **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] ![Multi Set](docs/images/node_setget.png) - **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 (`_`). - 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 `_ [ ]`. - 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](https://github.com/kijai/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] ![Constant setter 1](docs/images/node_constant_setter_1.png) ![Constant setter 2](docs/images/node_constant_setter_2.png) ![Constant setter 3](docs/images/node_constant_setter_3.png) - **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 #### 11. Any Switch [darkilNodes] ![Any Switch](docs/images/node_switch_any.png) - **Category**: darkilNodes/logic - **Description**: Passes through the first input that is both connected and enabled. Tolerant like rgthree's Any Switch — it never errors when nothing is connected. - **Features**: - Dynamic `any_*` inputs — a new slot appears once the last one is filled; extra empty slots are trimmed automatically. - A per-input checkbox in the right column: uncheck it to skip that input without disconnecting the upstream node. - Inputs are scanned top to bottom; the first enabled + connected one is returned. Falsy-but-valid values (`0`, empty string) still pass through. - If nothing qualifies, the node outputs `None` instead of raising. - Any-type input and output (`*`) — accepts and forwards any data type. - **Inputs**: - `any_1`, `any_2`, … (ANY): the values to switch between (added dynamically) - **Outputs**: - `value` (ANY): the first enabled + connected input (or `None`) #### 12. Show Any [darkilNodes] ![Show Any](docs/images/node_show_any.png) - **Category**: darkilNodes/logic - **Description**: A universal preview node that renders whatever is connected, chosen by the value's runtime type, and passes the value through unchanged on `value`. - **Features** — renders by detected type: - **Text / number** — selectable, copyable text. - **JSON** (a dict, or a string that parses as JSON) — a collapsible tree with a **Tree / Raw** toggle. - **Boolean** — a large green check / red cross. - **Number list** (`[1, 2, 3]`, or a numeric-array string) — a read-only equalizer chart with value labels and auto-range. - **Matrix / list of lists** (`[[...], [...]]`) — stacked mini-equalizers, 10 per page with prev/next pagination. - **Image(s) / mask** — inline image preview(s); masks are shown as grayscale. - **Video** — an HTML `

Any Switch [darkilNodes]

Inputs (1)

Outputs (1)