ComfyUI Local Wildcards

A robust localized wildcard, random choices, and nested pattern expansion node for ComfyUI. Supports simple .txt files, hierarchical structured .yaml / .yml configurations, and nested .json formats. It is designed as a powerful, lightweight replacement for older wildcard nodes that are no longer maintained.

Features

• __wildcard__ syntax — pulls a random line/value from a matching wildcard file (e.g. __color__, __folder/color__)
• Dynamic prompt syntax — inline random choices without needing a file, e.g. {red|blue|green}
• Weighted choices — bias certain options to appear more/less often, e.g. {red::0.2|blue::0.8}
• Multi-select — pick several options at once, e.g. {2$$red|blue|green} or a random range {1-3$$red|blue|green}
• Custom separators — control how multiple picks are joined, e.g. {1-3$$ and $$red|blue|green}
• Wildcards inside dynamic prompts — combine both systems, e.g. {1-3$$ and $$__Round__}
• Nested wildcards — wildcard results can themselves contain more __wildcards__ or {dynamic|prompts}, fully resolved recursively
• Glob pattern matching — reference a random file within a folder, e.g. __folder/*__
• Escape characters — use \{, \}, \|, \$, \_ to include these characters literally
• Multiple file formats — .txt, .yaml/.yml, and .json wildcard files are all supported
• Seed control — seed_mode (fixed/random) and seed inputs let you lock in a specific combination or randomize every run
• Insert Wildcard dropdown — browse all detected wildcards, grouped by folder, and insert them into your prompt without typing
• Live preview box — after running, see the fully resolved text with resolved parts highlighted in 【 】 brackets, while the plain output text (sent to your generation nodes) stays clean
• Auto-refresh — wildcard files are automatically rescanned when changed; no restart needed

Quick Start

1. Installation

Option A — Via ComfyUI Manager (recommended) Search for ComfyUI Local Wildcards in the Manager's custom node browser and click Install.

Option B — Manual Install Open your terminal inside your ComfyUI custom_nodes folder and run:

cd ComfyUI/custom_nodes
git clone https://github.com/DutchyDutch/ComfyUI_Local_Wildcards.git