Extensions/PromptFlow
ComfyUI Extension

PromptFlow

Modular prompt engineering with wildcards, variations preview, auto-sort, and presets. Two modes (Simple/Extended), LoRA Manager integration, and 7 themes shared with…

By maartenharms·Created 6 months ago·Updated 6 months ago· 18
maartenharms/comfyui-promptflow
Nodes2
On cloudLocal install
CategoryPromptFlow
Stars18
Updated6 months ago

Nodes (2)

PromptFlow
PromptFlow
PromptFlow Variations
PromptFlow
Readme

📝 PromptFlow

Modular Prompt Engineering for ComfyUI

GitHub license GitHub stars GitHub release Ko-fi

Features | Installation | Wildcards | Variations | Examples | Support

See It In Action

Simple Mode + Presets + Auto-Sort - Quick prompting with built-in presets

PromptFlow Demo

Variations Preview - See all wildcard combinations before generating

PromptFlow Variations

LoRA Manager + Saving Presets - Trigger words integration and custom presets

PromptFlow LoRA

PromptFlow is a free and open source ComfyUI custom node that organizes your prompt workflow. Build structured prompts with wildcards, presets, and intelligent auto-sorting!

  • 📝 Two Modes - Simple (3 fields) or Extended (11 fields) for any workflow
  • 🎲 Wildcards - {option1|option2|option3} syntax with 4 selection modes
  • 📁 File Wildcards - __folder/filename__ loads from ComfyUI/wildcards/
  • 🔀 Auto-Sort - Paste any prompt, auto-distribute to categories
  • 🎯 Variations Node - Preview all combinations before generating
  • 💾 Presets - Built-in + custom presets with export/import
  • 🎨 7 Themes - Shared theme system with FlowPath
  • 🔗 LoRA Manager - Trigger words integration

✨ Key Features

| Feature | Description | |---------|-------------| | 📝 Simple Mode | 3 focused fields: Main Prompt, Style, Quality | | 📋 Extended Mode | 11 granular fields: Subject, Character, Expression, Outfit, Pose, Location, Style, Camera, Lighting, Quality, Custom | | 🎲 Wildcards | {a\|b\|c} inline syntax + __file__ wildcard files | | 🔒 Field Modes | Fixed, Random, Increment, Decrement per field | | 🎯 Variations Node | See all possible combinations with seed hints | | 🔀 Auto-Sort | Paste prompts, auto-categorize with 200+ keywords | | ↕️ Drag & Drop | Reorder extended mode fields | | 💾 Presets | 22 built-in + unlimited custom presets | | 📤 Export/Import | Share presets as JSON | | 🔗 LoRA Manager | Auto-prepend trigger words | | 🎨 7 Themes | Synced with FlowPath | | ⌨️ Shortcuts | Ctrl+Z undo, right-click menus |

🚀 Quick Start

Installation

Method 1: ComfyUI Manager (Recommended)

  1. Open ComfyUI Manager
  2. Search for "PromptFlow"
  3. Click Install
  4. Restart ComfyUI

Method 2: Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/maartenharms/comfyui-promptflow

Then restart ComfyUI.

Method 3: Manual Download

  1. Download the latest release ZIP
  2. Extract to ComfyUI/custom_nodes/comfyui-promptflow
  3. Restart ComfyUI

Basic Usage

  1. Add PromptFlow node to your workflow (under "📝 PromptFlow" category)
  2. Fill in prompt fields - Or use Auto-Sort to paste existing prompts
  3. Connect outputs:
    • positive → CLIP Text Encode (positive)
    • negative → CLIP Text Encode (negative)
  4. Generate!

🎲 Wildcard System

Inline Wildcards

Use {option1|option2|option3} in any field:

a {beautiful|elegant|stunning} {woman|lady} in a {forest|garden|meadow}

File Wildcards

Use __folder/filename__ to load from text files:

__characters/fantasy__ wearing __outfits/medieval__

Place .txt files in ComfyUI/wildcards/ folder (one option per line).

Field Modes

Each field can have its own mode:

| Mode | Behavior | |------|----------| | 🔒 Fixed | Always uses first option | | 🎲 Random | Random selection (seed-based) | | 📈 Increment | Cycles forward through options | | 📉 Decrement | Cycles backward through options |

🎯 Variations Node

The PromptFlow Variations node shows all possible prompt combinations:

  1. Connect prompt_data output → Variations node input
  2. See total combinations (e.g., "24 variations from 3 wildcards")
  3. Click rows to select specific variations
  4. Shift+click for range selection
  5. Queue Selected to generate only chosen variations

Perfect for batch generation with specific combinations!

🔀 Auto-Sort

Paste any prompt and auto-distribute to the right categories:

  1. Click the ☰ menu → Auto-Sort
  2. Paste your prompt
  3. Preview shows categorization
  4. Click Apply

Works in both Simple and Extended modes!

💾 Preset System

Built-in Presets

  • 10 Style Presets - Photorealistic, Cinematic, Anime, Oil Painting, etc.
  • 5 Quality Presets - Standard, Ultra, Minimal, Photo, Artistic
  • 7 Negative Presets - Standard, Anatomy Fix, Full, NSFW Filter, etc.

Custom Presets

  • Save button on each field to save content
  • Load button to apply presets
  • Right-click fields for quick save
  • Global Presets save entire prompt state

Export/Import

Share presets via ☰ menu → Export/Import Presets

🔗 LoRA Manager Integration

PromptFlow integrates seamlessly with LoRA Manager:

[LoRA Manager] --trigger_words--> [PromptFlow] --positive--> [CLIP Encode]

Trigger words are automatically prepended to your positive prompt.

📋 Node Reference

PromptFlow (Main Node)

Inputs: | Input | Type | Description | |-------|------|-------------| | seed | INT | For deterministic wildcard selection | | trigger_words | STRING | From LoRA Manager (optional) | | input_prompt | STRING | Prepend to output (optional) |

Outputs: | Output | Type | Description | |--------|------|-------------| | positive | STRING | Combined positive prompt | | negative | STRING | Negative prompt | | prompt_data | STRING | For Variations node |

PromptFlow Variations

Inputs: | Input | Type | Description | |-------|------|-------------| | prompt_data | STRING | From PromptFlow's prompt_data output |

Shows all wildcard combinations with selection and batch queuing.

🎨 Themes

Choose from 7 beautiful themes in Settings → PromptFlow → Theme:

| Theme | Primary | Accent | Vibe | |-------|---------|--------|------| | 🌊 Ocean Blue | Blue | Teal | Cool ocean waves | | 🌲 Forest Green | Green | Amber | Lush nature | | 🎠 Pink Pony Club | Hot Pink | White | Fun and playful | | 🧡 Odie | Orange | Sandy Tan | Warm and friendly | | 💜 Umbrael's Umbrage | Purple | Gold | Regal and mysterious (DEFAULT) | | ⚪ Plain Jane | Gray | Gray | Simple and minimal | | 🦇 The Dark Knight | Black | Yellow | For when Gotham needs you |

Note: Themes are shared with FlowPath!

⌨️ Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | Ctrl+Z | Undo | | Ctrl+Y | Redo | | Escape | Close modal/dropdown | | Right-click | Context menu (Copy, Paste, Save, Clear) |

📁 Example Workflows

Check out the examples folder for ready-to-use workflows:

  • PromptFlow Example Workflow (Simple).json - Basic 3-field workflow
  • PromptFlow Example Workflow (Extended Mode with Wildcards & Variations).json - Full featured
  • PromptFlow Example Workflow (LoRA Manager Integration).json - Trigger words workflow

All workflows include explanatory notes to help you get started!

🛠️ Troubleshooting

PromptFlow node not appearing

  1. Make sure you extracted to ComfyUI/custom_nodes/comfyui-promptflow
  2. Restart ComfyUI completely
  3. Check console for errors (search for "PromptFlow")

Wildcards not expanding

  1. Check syntax: {option1|option2} for inline, __filename__ for files
  2. For file wildcards, ensure .txt file exists in ComfyUI/wildcards/
  3. Check field mode is set to Random/Increment (not Fixed)

Auto-Sort not categorizing correctly

  1. Auto-Sort uses keyword matching - some tags may be ambiguous
  2. Review the preview before applying
  3. Manually adjust categories as needed after applying

Theme not applying

  1. Go to Settings → 📝 PromptFlow → Theme
  2. Select your theme
  3. Node should update instantly
  4. If not, try reloading ComfyUI browser tab

💝 Support Development

PromptFlow is 100% free and open source

If you find it useful, consider supporting development:

☕ Ko-fi: https://ko-fi.com/maartenharms
⭐ Star the repo: https://github.com/maartenharms/comfyui-promptflow
📣 Share with others: Help spread the word!

Every donation helps support continued development and new features

🤝 Contributing

PromptFlow is open source and welcomes contributions! Whether you're fixing bugs, adding features, or improving documentation, we'd love your help.

How to Contribute

  1. Report Bugs - Open an issue describing the problem
  2. Request Features - Share your ideas for new features
  3. Submit Code - Fork, code, and submit a Pull Request
  4. Improve Docs - Fix typos, add examples, clarify instructions

Contribution Ideas

  • ✅ Add new auto-sort keywords
  • ✅ Create new preset packs
  • ✅ Improve wildcard parsing
  • ✅ Fix bugs and improve performance
  • ✅ Enhance documentation
  • ✅ Add new field types

📜 License

MIT License - Free to use, modify, and distribute

Copyright (c) 2026 Maarten Harms

See LICENSE file for full details.

🔗 Also By Me

| Extension | Description | |-----------|-------------| | FlowPath | Intelligent path organization for ComfyUI - A1111-style counter, template variables, auto-detection, and 7 shared themes |

🙏 Credits

Created by Maarten Harms (Mern)

Special thanks to:

  • The ComfyUI community for feedback and support
  • Everyone who helped test and improve PromptFlow
  • Contributors who help make PromptFlow better
  • Users who share their workflows and presets

📞 Contact & Links

  • 🐙 GitHub: https://github.com/maartenharms/comfyui-promptflow
  • ☕ Ko-fi: https://ko-fi.com/maartenharms
  • 💬 Discord: @itsmern
  • 📧 Issues: https://github.com/maartenharms/comfyui-promptflow/issues

Made for the ComfyUI community 📝

Write better prompts - generate better images!