A ComfyUI custom-node pack for controlling node states and making prompt generation and testing faster without repeatedly copying prompts between nodes or interfaces.

Main benefits:

Control the state of any number of nodes and switch entire branches with one click by controlling their output nodes.
Test complete prompt lists sequentially.
Route up to ten prompts through independent parallel branches, for example different APIs, to speed up generation.
Work with positive-only or positive-and-negative prompt lists.
Keep prompt generation, testing, selection, saving, and reuse of selected prompts connected in one process.

Nodes

Node State Controller

Control the state of multiple workflow nodes from one place. Capture target nodes, assign an action to each, and apply them together with one click or an optional keyboard shortcut.

| Interface | Definition | | --- | --- | | Inputs | None | | Outputs | None |

Available actions are Mute, Unmute, Bypass, and Unbypass.

Press <code>Capture Target</code>.
Click the nodes you want to control.
Assign an action to each captured node.
Press the capture button again to stop capturing targets.
Press <code>APPLY</code> or use the configured keyboard shortcut to change all target states.

PromptOrchestrator

Brings prompt generation and prompt testing into one central node. Together with the companion nodes, it connects the complete prompt process without manual copy-pasting between nodes or other interfaces.

Test prompt lists sequentially.
Route prompts through Prompt Distributor and Prompt Slot Pickers to up to ten independent branches, for example API branches, to speed up generation.
Use positive-only or positive-and-negative prompt lists.
Use PromptOrchestrator as the central interface for selecting, saving, and reusing prompts with Prompt Image Picker and Save String for Orchestrator.

| Interface | Definition | | --- | --- | | Inputs | <code>curated_prompts_folder</code> (<code>STRING</code>), <code>generated_prompts_folder</code> (<code>STRING</code>), <code>multi_prompt_testing_editor</code> (<code>STRING</code>), <code>prompt_generation_editor</code> (<code>STRING</code>), <code>use_prompt_generation_branch</code> (<code>BOOLEAN</code>), <code>system_prompt</code> (<code>STRING</code>), <code>prompt_testing_format</code> (<code>COMBO</code>: <code>Positive only</code> or <code>Positive + Negative</code>) | | Outputs | <code>Positive Prompt</code> (<code>STRING</code> list), <code>Negative Prompt</code> (<code>STRING</code> list), <code>Prompt Generation</code> (<code>STRING</code>), <code>System Prompt</code> (<code>STRING</code>) |

<details> <summary>Prompt formats, outputs, and PromptStorage</summary>

Choose between <code>Positive only</code> and <code>Positive + Negative</code>. Positive-only mode treats every non-empty line as one prompt. Positive-and-negative mode reads the fixed ordered pairs <code>P1=...;N1=...</code>, <code>P2=...;N2=...</code>, and so on.

The active <code>Prompt Testing</code> or <code>Prompt Generation</code> tab determines which prompt output is used. The System Prompt output remains available in both modes.

PromptStorage gives one PromptOrchestrator its own <code>CuratedPrompts</code> and <code>GeneratedPrompts</code> folders. Open <code>Prompt Testing → Sources</code> and press <code>Prompt Storage</code> once to create it and fill the source paths automatically. This storage is needed to load, save, and reuse prompts safely with Save String for Orchestrator.

Save String for Orchestrator

Saves the prompts selected in Prompt Image Picker into the PromptStorage of its connected PromptOrchestrator, so they can be reused in PromptOrchestrator later without manual copy-pasting.

| Interface | Definition | | --- | --- | | Inputs | <code>content</code> (<code>STRING</code>), <code>filename_prefix</code> (<code>STRING</code>), <code>target_branch</code> (<code>COMBO</code>: <code>CuratedPrompts</code> or <code>GeneratedPrompts</code>) | | Output | <code>filename</code> (<code>STRING</code>) |

Create PromptStorage from the matching PromptOrchestrator.
Connect <code>Chosen Prompt</code> from Prompt Image Picker, or another string path originating from that PromptOrchestrator, to <code>content</code>.
Press <code>Detect Orchestrator</code> to connect this Save String node to the corresponding PromptOrchestrator.
Choose <code>CuratedPrompts</code> or <code>GeneratedPrompts</code> and set the filename prefix.

PromptStorage contains user data inside the installed node pack. Deleting, replacing, or uninstalling that directory can remove stored prompts. If a loaded workflow references missing storage, open <code>Prompt Testing → Sources</code> and press <code>Prompt Storage</code> to create an empty replacement. This restores operation but cannot restore the previous prompts.

</details>

Prompt Distributor

Starts the optional parallel prompt-testing pipeline. It takes the prompt list from PromptOrchestrator and works with Prompt Slot Pickers to forward individual prompts to separate branches, for example branches using different APIs.

| Interface | Definition | | --- | --- | | Inputs | <code>positive_prompts</code> (<code>STRING</code> list), <code>negative_prompts</code> (<code>STRING</code> list), <code>branches</code> (<code>INT</code>, 1 to 10) | | Output | <code>Prompt Manifest</code> (<code>ORCHESTRATION_PROMPT_MANIFEST</code>) |

Connect the positive and negative prompt lists from PromptOrchestrator, choose how many parallel branches should be active, and connect the Prompt Manifest to the Prompt Slot Pickers.

If the list contains more prompts than configured branches, only the prompts that fit are distributed and the remaining prompts are reported in the log.

</details>

Prompt Slot Picker

Place one Prompt Slot Picker in each parallel branch. Its slot number chooses which line from the Distributor prompt list is forwarded to the next node.

| Interface | Definition | | --- | --- | | Inputs | <code>prompt_manifest</code> (<code>ORCHESTRATION_PROMPT_MANIFEST</code>), <code>slot</code> (<code>INT</code>, 1 to 10) | | Outputs | <code>Positive Prompt</code> (<code>STRING</code>), <code>Negative Prompt</code> (<code>STRING</code>) |

<img src="assets/prompt-slot-picker.png" alt="Prompt Slot Picker node" width="560"> <details> <summary>How slots work</summary>

Slot 1 forwards the first prompt, Slot 2 the second prompt, and so on. Assign a different slot to each parallel branch. If the selected slot has no prompt, that branch does not run.

</details>

Prompt Collector

Brings the generated images from all active parallel branches back together and returns them with their matching prompts in slot order for the next processing or review step.

| Interface | Definition | | --- | --- | | Inputs | <code>prompt_manifest</code> (<code>ORCHESTRATION_PROMPT_MANIFEST</code>), <code>image_1</code> to <code>image_10</code> (optional lazy <code>IMAGE</code> inputs) | | Outputs | <code>Images</code> (<code>IMAGE</code> list), <code>Positive Prompts</code> (<code>STRING</code> list), <code>Negative Prompts</code> (<code>STRING</code> list), <code>Prompt Count</code> (<code>INT</code>), <code>Active Slots</code> (<code>STRING</code>) |

<img src="assets/prompt-collector.png" alt="Prompt Collector node" width="420"> <details> <summary>Collection behavior</summary>

Only active image inputs are requested. Each active slot must provide exactly one image; incomplete results are rejected instead of silently returned. Original image dimensions and prompt order are preserved.

</details>

Prompt Image Picker

Provides the optional final review step after the Collector, or for any matching image and prompt lists. It pauses the workflow so you can select images, inspect them, edit their prompts, and forward only the selected images to the next node.

| Interface | Definition | | --- | --- | | Inputs | <code>images</code> (<code>IMAGE</code> list), <code>positive_prompts</code> (<code>STRING</code> list), <code>negative_prompts</code> (<code>STRING</code> list), <code>timeout</code> (<code>INT</code>, 1 to 86,400), <code>on_timeout</code> (<code>COMBO</code>: <code>Keep all</code> or <code>Cancel</code>), <code>display_mode</code> (<code>COMBO</code>: <code>Open picker</code> or <code>Compact notification</code>) | | Outputs | <code>Chosen Prompt</code> (<code>STRING</code>), <code>Images</code> (<code>IMAGE</code> list), <code>Indexes</code> (<code>STRING</code>) |

<img src="assets/prompt-image-picker.png" alt="Prompt Image Picker" width="620"> <details> <summary>Selection and timeout behavior</summary> <img src="assets/Prompt%20Image%20Picker%20demo.gif" alt="Selecting images and editing prompts with Prompt Image Picker" width="760">

The three input lists must contain the same number of items, from one to ten. The gallery supports selection, prompt editing, zoom, and pan while returning the original image tensors unchanged.

A timeout can either keep all images with the latest valid prompt edits or cancel execution.

</details>

Compatibility

Python 3.10 or newer

Installation

Clone the repository into the ComfyUI custom-nodes directory and restart ComfyUI:

cd ComfyUI/custom_nodes
git clone https://github.com/flows-and-frames/ComfyUI-Orchestration-Toolkit.git