ComfyUI Wildcard Prompt

Custom node for ComfyUI that resolves wildcard tokens in prompt text.

Features

• Resolves __wildcard__ tokens from .txt files
• Deterministic output for the same seed and wildcard set
• Supports either the local prompt widget or an incoming string_in
• Returns both the final STRING and the USED_SEED
• Packaged with standard ComfyUI custom node metadata for reuse

Node

Wildcard Prompt

Inputs:

• prompt: multiline text, used when no external prompt input is connected
• string_in: optional external prompt input string
• seed: built-in ComfyUI seed widget with post-generate controls
• wildcard_path: path to a folder containing wildcard .txt files

Outputs:

• STRING: final resolved prompt string
• USED_SEED: actual seed used for the resolution

Wildcard Format

Example file:

color.txt

red
yellow
blue
green

Prompt:

The __color__ apple

Possible result:

The red apple

Behavior

• __key__ resolves from <wildcard_path>/key.txt
• Blank lines are ignored
• Missing or empty wildcard files raise an error
• Resolution is deterministic for the same prompt, seed, and wildcard files
• Different seed values can select different lines from the same wildcard file
• If string_in is connected, it overrides the prompt text field

Installation

Place this folder inside ComfyUI's custom_nodes directory, or symlink it there, so ComfyUI can import the package entrypoint:

ComfyUI/custom_nodes/wildcard/

Restart ComfyUI after installing or updating the node.

Packaging

This repository includes the standard files commonly used by ComfyUI-Manager-compatible custom node packs:

• pyproject.toml
• requirements.txt
• LICENSE
• .tracking

If you want to publish it through the broader ComfyUI registry ecosystem, see docs/PUBLISHING.md.