demo.webm
🎬 Watch the demo: See wildcard sub-selection and tag completion in action!
ComfyUI-TagComplete is an advanced extension that brings professional-grade tag completion and wildcard sub-selection to ComfyUI, inspired by the renowned a1111-sd-webui-tagcomplete. Designed for AI artists and prompt engineers who demand precision and efficiency in their workflow.
- 🧠 Intelligent Tag Completion: Real-time suggestions from comprehensive CSV databases (Danbooru, e621, custom tags)
- 🎪 Wildcard Sub-Selection: Revolutionary a1111-style workflow for complex prompt building
- 🌐 Multi-Source Support: Seamlessly integrates wildcards from multiple locations and extensions
- ⚡ Performance Optimized: Lightweight, fast, and doesn't slow down your ComfyUI experience
- 🔧 Highly Customizable: Extensive settings to tailor the experience to your needs
- AI Artists who want to streamline their prompt creation process
- Prompt Engineers needing precise control over tag combinations
- Content Creators looking to maintain consistency across generations
- Power Users who want professional-grade tools in their workflow
The standout feature is the wildcard sub-selection system - type __, select a wildcard, and instantly browse through individual options with smart text handling and overflow management. This transforms complex prompt building from a chore into an intuitive, creative process.
ComfyUI-TagComplete now includes a powerful WildcardProcessor node that brings advanced prompt processing capabilities directly to your ComfyUI workflows, eliminating the need to install the entire Impact Pack just for wildcard processing.
- 🧠 Advanced Wildcard Processing: Process complex prompts with wildcards in the format
__keyword__ - 🎲 Dynamic Options: Support for multiple choice options
{option1|option2|option3} - 📊 Weighted Randomization: Probability-based selection with syntax
weight::option - 🔢 Quantifiers: Select multiple items with syntax
count__keyword__ - 🎭 Custom Separators: Control output formatting with custom separators
- 🌱 Reproducible Results: Seed-based randomization for consistent outputs
Input: A beautiful __color__ landscape painting
Output: A beautiful red landscape painting
Input: A {cat|dog|bird} sitting on a {chair|table|floor}
Output: A cat sitting on a chair
Input: Create a {2::portrait|1::landscape} image
Output: Create a portrait image (66% chance) or landscape image (33% chance)
Input: 3__color__ flowers in a __container__
Output: red yellow blue flowers in a vase
Input: {apple$$, $$orange$$, $$banana$$}__fruit__
Output: apple, orange, banana fruits
- text (STRING, required): The prompt text containing wildcards and dynamic options
- seed (INT, optional): Randomization seed (0 = random seed)
- processed_text (STRING): The fully processed prompt with all wildcards resolved
The WildcardProcessor node seamlessly integrates with your existing ComfyUI workflows:
- Connect your prompt generation to the
textinput - Set a seed for reproducible results (optional)
- Connect the output to your text-to-image pipeline
- Generate with fully resolved, dynamic prompts!
This version introduces a1111-sd-webui-tagcomplete style wildcard sub-selection, making wildcard usage more intuitive and powerful:
- Type
__to see available wildcards - Select a wildcard with arrow keys and press Enter → inserts
__wildcard_name__ - Auto-show options → immediately displays all options from that wildcard
- Select an option with arrow keys and press Enter → replaces wildcard with chosen option
- ESC → keeps inserted wildcard and closes options
- Smart parsing: Handles wildcards with complex paths (e.g.,
__mbe/blwjob/blwjb__) - Line-by-line options: Each line in wildcard file becomes a separate option
- Text overflow handling: Long options are truncated with hover expansion
- Full compatibility: Works with existing wildcard files and formats
- Multiple sources: Supports wildcards from repository, ComfyUI/models, DynamicPrompts, and Impact-Pack
- Repository
wildcards/folder - ComfyUI
models/wildcards/ - DynamicPrompts
wildcards/ - Extra model paths configuration
- Impact-Pack wildcards
- Impact-Pack.ini custom paths
This extension is based on ComfyUI-Custom-Scripts.
The following files in the tags folder are based on or inspired by a1111-sd-webui-tagcomplete:
- danbooru.csv (updated and cleaned, deprecated tags removed as of February 2026)
- danbooru_e621_merged.csv
- extra-quality-tags.csv
Additionally, this extension includes wildcard sub-selection functionality inspired by a1111-sd-webui-tagcomplete, allowing users to select individual options from wildcard files with an intuitive workflow.
cd ComfyUI/custom_nodes
git clone https://github.com/huchukato/comfy-tagcomplete.git
If you're installing manually or want to use wildcards with Impact Pack, you may need to copy the wildcards folder:
-
Copy wildcards to Impact Pack:
cp -r /path/to/comfy-tagcomplete/wildcards /path/to/ComfyUI/custom_nodes/comfyui-impact-pack/wildcards/
-
Restart ComfyUI to load the new wildcards
Note: The extension automatically detects wildcards from multiple sources, but manual copying ensures maximum compatibility with Impact Pack and other extensions.
Enable- Enable the feature
Main Tags file- Main tags CSV file
- Targets all CSV files except those starting with 'extra' in the tags folder
Extra Tags file- Additional tags CSV file
- Targets only CSV files starting with 'extra' in the tags folder
Translate file⭐new- Set a translation file
Delimiter- Tag separator character
- Choose from comma (,), period (.), or none
Add 'Space' after separator- Add a space after the separator
Insert Tag on Tab key- Insert tag with Tab key
Insert Tag on Enter key- Insert tag with Enter key
Max Suggestions to Display- Number of tag suggestions to display
- 0 displays all
but becomes heavy (extremely heavy)
Add Wiki Link Button- Add wiki (danbooru / e621) link button to the left of tag suggestions
Replace '_' to 'Space'- Replace underscores in tags with spaces
Completion delay(ms)- Time before displaying tag suggestions after input
Enable Embeddings- Include Embedding files in suggestions
Enable LoRAs- Include LoRA files in suggestions
Enable Wildcards⭐new- Include wildcards in suggestions
Restrict Alias- When ON, Aliases (like 1girls => 1girl) are only displayed on exact match
- For example, the alias "1girls => 1girl" will only be displayed when you type up to "1girls"
You can search by specifying categories.
Enter --○○ to specify a category.
Available categories are listed in Category Map.
- Example
--character fate- Displays only results with category
characterfrom thefatesearch results.
- Displays only results with category
You can search with prefix settings.
Enter ++○○ to set a prefix.
Multiple prefixes can be set.
- Example
++pink skirt- When searching for "skirt" and selecting
pleated skirt, the result will bepink pleated skirt.
- When searching for "skirt" and selecting
- Fixed nested wildcard processing - Now properly processes wildcards like
__mbe/prmpt/lctns/rndmlctns__ - Fixed dynamic prompts - Correctly handles
{__indoor__|__outdoor__|__special__}with nested wildcards - Impact Pack compatibility - Implemented original Impact Pack processing logic
- Pattern matching - Added depth-agnostic wildcard pattern matching
- Stable reference point - This commit serves as the stable working baseline
- Wildcard option selection in a1111-sd-webui-tagcomplete style
- Auto-show options when inserting wildcards
- Keyboard navigation with arrow keys and Enter
- Category filtering and prefix support
- WildcardProcessor node for advanced wildcard processing