comfyui-prompt-control

[!NOTE] v3.0.0 is backwards compatible with existing workflows, but requires at least ComfyUI v0.8.0 The parser was rewritten using parsy. It is intended to have the same behaviour as the old parser, but is significantly faster. Please report any bugs or incompatibilities you find.

Notable changes

• PC: Schedule Prompt now strips surrounding whitespace by default, which may change some prompts. Add NOSTRIP() to your prompt to restore previous behaviour.

What can it do?

• A1111-style prompt scheduling and filtering without noodle soup.
• LoRA loading and scheduling using ComfyUI's built-in hook system.
• Masking, composition and area control (regional prompting) with an implementation of Attention Couple, also fully schedulable.
• Advanced prompt encoding
  • Per-encoder prompts for models with multiple text encoders, such as SDXL and Flux.
  • Prompt combinators like BREAK, as well as CAT, AVG() and AND corresponding to ComfyUI's ConditioningConcat, ConditioningAverage and ConditioningCombine nodes.
  • Different weight interpretation types (ComfyUI, A1111, compel, etc.)
  • Prompt masking with an implementation of cutoff.
• Organize complicated prompts with segments and prompt macros.
• Schedule your own encoder nodes, allowing prompt control of eg. video or audio models with non-text inputs.

All features are fully schedulable unless otherwise stated. See the scheduling syntax documentation to get started.

If you find prompt scheduling inconvenient for some reason, PCTextEncode can be used as a drop-in replacement for CLIPTextEncode to get everything else.

This workflow shows LoRA scheduling and prompt editing and compares it with the same prompt implemented with built-in ComfyUI nodes. You can also find it in the template library.

Compatibility

Prompt Control uses graph generation, and tries to delegate functionality to core ComfyUI wherever possible, implementing any hooks and patches in a way that is maximally compatible. This means that it should just work in most cases, even with models and nodes not explicitly supported.

If you encounter issues as a user or if you're a node developer and Prompt Control somehow breaks something, feel free to file a bug report.

Requirements

The v3 node schema uses features that require at least ComfyUI v0.8.0

If you run into problems, update ComfyUI first.

Core nodes

Note: The documentation refers to the nodes with their internal names for consistency. The display name may change, but ComfyUI's search will always find the nodes with the internal name. PCLazyTextEncode and PCLazyLoraLoader are the main ones you'll want to use, also known as PC: Schedule Prompt and PC: Schedule LoRas.

PCLazyTextEncode and PCLazyTextEncodeAdvanced

PCLazyTextEncode uses ComfyUI's lazy graph execution mechanism to generate a graph of PCTextEncode and SetConditioningTimestepRange nodes from a prompt with schedules. This has the advantage that if a part of the schedule doesn't change, ComfyUI's caching mechanism allows you to avoid re-encoding the non-changed part.

for example, if you

Verified Sep 12