Dynamic Prompt Nodes

ComfyUI custom nodes for dynamic prompt generation with full wildcard and variable support. Implements the sd-dynamic-prompts syntax natively — no external generator dependency.

Features

• Random sampling — pick random variants from {option1|option2|option3}
• Combinatorial generation — enumerate every possible prompt combination
• Cyclical sampling — cycle through options in order across generations
• Wildcards — substitute values from .txt or .yaml wildcard files using __wildcard_name__
• Variables — define and reuse values within a prompt via ${name=value}
• PPP tags — full support for <ppp:set>, <ppp:echo>, <ppp:if>, <ppp:stn>, and <ppp:ext> tags from sd-webui-prompt-postprocessor
• Model family inference — auto-detects SD1, SDXL, SD3, or Flux from the model input
• Model variant override — manually specify Pony, Illustrious, Anima, or NoobAI variants for conditional tags
• Prompt cleanup — optional duplicate removal, extra space normalization, and empty construct cleanup
• Negative prompt collection — <ppp:stn> content is automatically collected and merged into the negative prompt output

Installation

Via ComfyUI Manager

Search for Dynamic Prompt Nodes and install.

Manual

cd ComfyUI/custom_nodes
git clone https://github.com/cesasol/dynamic_prompt_nodes
cd dynamic_prompt_nodes
pip install -e .

Place wildcard files (.txt or .yaml) in ComfyUI/custom_nodes/dynamic_prompt_nodes/wildcards/.

Nodes

Dynamic Prompt (Random)

Processes a prompt template and returns a randomly sampled string each generation.

Inputs: template (STRING), seed (INT) Output: prompt (STRING)

Dynamic Prompt (Combinatorial)

Enumerates all combinations from a template. Feed into a batch to generate every variant.

Inputs: template (STRING), index (INT) Outputs: prompt (STRING), all_prompts (STRING), total_count (INT)

Dynamic Prompt (Cyclical)

Steps through options in order, advancing one position each generation. Useful for systematic variation without randomness.

Inputs: template (STRING) Output: prompt (STRING)

Prompt with Wildcards

Advanced prompt processor with full PPP tag support, model family inference, and optional cleanup. Processes both positive and negative templates simultaneously.

Inputs:

• model (MODEL) — model input for family inference
• positive_template (STRING, multiline) — positive prompt template
• negative_template (STRING, multiline) — negative prompt template
• seed (INT) — random seed for reproducible generation
• ignore_repeats (BOOLEAN) — remove duplicate keywords
• cleanup_extra_spaces (BOOLEAN) — normalize whitespace
• cleanup_empty_constructs (BOOLEAN) — remove empty keywords and attention tags
• model_variant (STRING, optional) — override variant: pony, illustrious, anima, noobai

Outputs: positive (STRING), negative (STRING)

Model Family Auto-Detection:

• SD1 — diffusion_model.input_blocks length of 8
• SDXL — diffusion_model.input_blocks length of 9
• SD3 — diffusion_model.in_channels of 16
• Flux — diffusion_model.img_in attribute present

System Variables (available in <ppp:if> conditions):

• _is_sd1, _is_sdxl, _is_sd3, _is_flux — base architecture
• _is_pony, _is_illustrious, _is_anima, _is_noobai — variant flags
• _is_sd — true for SD1, SDXL, SD3, and their variants

Syntax

Variants

| Syntax | Description | |--------|-------------| | {cat\|dog\|bird} | Pick one randomly | | {2$$cat\|dog\|bird} | Pick exactly 2 | | {1-3$$cat\|dog\|bird} | Pick 1 to 3 | | {2$$ and $$cat\|dog} | Pick 2 with custom separator | | {3::rare\|1::common} | Weighted selection | | {@cat\|dog\|bird} | Cyclical (steps each call) |

Wildcards

| Syntax | Description | |--------|-------------| | __animals__ | Substitute from wildcards/animals.txt | | __colors/warm__ | Nested key or subdirectory | | __colors*__ | Glob match wildcard names | | __~animals__ | Random sampler (explicit) | | __@animals__ | Cyclical sampler |

Variables

| Syntax | Description | |--------|-------------| | ${x=value} | Assign (non-immediate — re-evaluated each use) | | ${x=!value} | Assign immediate — fixed once, same value every use | | ${x} | Read variable | | ${x:fallback} | Read with default |

PPP Tags (sd-webui-prompt-postprocessor)

Full support for <ppp:> tags. These are evaluated during prompt processing and can control output dynamically.

| Tag | Description | |-----|-------------| | <ppp:set var=x>${value}</ppp:set> | Set variable x to the evaluated content | | <ppp:set var=x evaluate>${value}</ppp:set> | Set variable x to the evaluated string (not AST) | | <ppp:set var=x add>${value}</ppp:set> | Append to existing variable x | | <ppp:set var=x ifundefined>${value}</ppp:set> | Set only if x is not already defined | | <ppp:echo var=x /> | Output the value of variable x | | <ppp:echo var=x>fallback</ppp:echo> | Output x or fallback if undefined | | <ppp:if x eq 1>${content}</ppp:if> | Conditional block with comparison | | <ppp:if x eq 1>${a}</ppp:elif x eq 2>${b}</ppp:else>${c}</ppp:if> | If/elif/else chain | | <ppp:stn>${neg_content}</ppp:stn> | Send content to negative prompt (start position) | | <ppp:stn e>${neg_content}</ppp:stn> | Send content to negative prompt (end position) | | <ppp:ext lora="name" weight="0.8" /> | Generate <lora:name:0.8> tag | | <ppp:ext lora="name" triggers="tag1, tag2" /> | Generate LoRA tag with trigger words |

Condition Operators for <ppp:if>:

• eq, ne, gt, lt, ge, le — numeric comparisons
• contains — substring match
• in — value in comma-separated list
• and, or, not — logical combinators
• Parentheses () for grouping

Model Family Conditions:

<ppp:if _is_pony>score_9, score_8_up, score_7_up</ppp:if>
<ppp:if _is_sdxl and not _is_pony>masterpiece, best quality</ppp:if>

Wildcard Files

Text format (wildcards/animals.txt):

cat
dog
bird
# lines starting with # are comments

YAML format (wildcards/styles.yaml):

painting:
  - oil painting
  - watercolor
  - gouache
photo:
  - photograph
  - cinematic

Reference nested keys with /: __styles/painting__

Links

• sd-dynamic-prompts syntax reference
• sd-dynamic-prompts — the A1111 equivalent
• sd-webui-prompt-postprocessor syntax — PPP tag reference
• sd-webui-prompt-postprocessor — the A1111 PPP equivalent
• ROADMAP.md — ComfyUI encoding behavior reference for BREAK, AND, and [] brackets