adieyal / comfyui-dynamicprompts

ComfyUI custom nodes for Dynamic Prompts
MIT License
187 stars 20 forks source link

ComfyUI-DynamicPrompts Custom Nodes

ComfyUI-DynamicPrompts is a custom nodes library that integrates into your existing ComfyUI Library. It provides nodes that enable the use of Dynamic Prompts in your ComfyUI. The nodes provided in this library are:

  1. Random Prompts - Implements standard wildcard mode for random sampling of variants and wildcards.
  2. Combinatorial Prompts - Iterates through every possible combination of random values in a prompt.
  3. I'm Feeling Lucky - Uses the given prompt to download a related prompt from Lexica.art.
  4. Magic Prompt - Employs a neural network to add relevant modifiers to your prompt.
  5. Jinja2 Templates - Allows you to write prompts using Jinja2 templates.

Nodes can be found in the Dynamic Prompts menu:

Useful Links

Installation

Using ComfyUI-Manager

  1. Install ComfyUI-Manager if it isn't already.
  2. Press Install Custom Nodes from the ComfyUI-Manager menu
  3. Search for dynamicprompts
  4. Click install

Manual installation

Follow the steps below to install the ComfyUI-DynamicPrompts Library. These commands assume the your current working directory is the ComfyUI root directory.

  1. Clone the repository:
    git clone https://github.com/adieyal/comfyui-dynamicprompts custom_nodes/comfyui-dynamicprompts
  2. Install the required Python packages:
    python -m pip install -r custom_nodes/comfyui-dynamicprompts/requirements.txt
  3. Run install.py:
    python custom_nodes/comfyui-dynamicprompts/install.py
  4. mkdir custom_nodes/comfyui-dynamicprompts/wildcards
  5. (Optional) download a wildcard collection and copy it into this new wildcards folder.
  6. Restart your ComfyUI.
  7. Example workflows can be found in custom_nodes/comfyui-dynamicprompts/example_workflows.

Wildcards

The extension looks for wildcard files in custom_nodes/comfyui-dynamicprompts/wildcards. It supports wildcard files in .txt, .json and .yaml (example format).

There are many pre-built wildcards collections available. Here are a few to get you started:

Node Outputs

All nodes in this library produce a String output that can typically be passed into Clip Text Encode Prompts. Both positive and negative nodes are supported.

Please note, since ComfyUI is inherently stateless, some nodes might have a slightly unexpected behavior:

Roadmap

  1. This is a quick and dirty release with some known limitations such as non-configurable random seeds, inability to select the MagicPrompt model, and absence of several other configuration features.
  2. Currently, the only way to view the generated prompt is through console output. A future release will introduce nodes to display the generate prompt on screen and to write it to a file.
  3. It is not currently possible to chain generators, this functionality will be added in future releases.
  4. The installation script will be automated in the future for ease of use.