WAS Node Suite  

A node suite for ComfyUI with many new nodes, such as image processing, text processing, and more.

Share Workflows to the workflows wiki. Preferably embedded PNGs with workflows, but JSON is OK too. You can use this tool to add a workflow to a PNG file easily.

Consider donating to the project to help it's continued development.

Important Updates

• 12/15/2023 WAS-NS is not under active development. I do not have the time and have other obligations. Feel free to fork and continue the project. I will approve appropriate and beneficial PRs.
• [Updated 10/8/2023] BLIP is now a shipped module of WAS-NS and no longer requires the BLIP Repo
  • [Updated 5/29/2023] ASCII is deprecated. The new preferred method of text node output is STRING. This is a change from ASCII so that it is more clear what data is being passed.
  • The was_suite_config.json will automatically set use_legacy_ascii_text to false.
  • Video Nodes - There are two new video nodes, Write to Video and Create Video from Path. These are experimental nodes.

Current Nodes:

There is documentation from Salt AI available here: https://docs.getsalt.ai/md/was-node-suite-comfyui/

Extra Nodes

• CLIPTextEncode (BlenderNeko Advanced + NSP): Only available if you have BlenderNeko's Advanced CLIP Text Encode. Allows for NSP and Wildcard use with their advanced CLIPTextEncode.

  Notes:

• CLIPTextEncode (NSP) and CLIPTextEncode (BlenderNeko Advanced + NSP): Accept dynamic prompts in <option1|option2|option3> format. This will respect the nodes input seed to yield reproducible results like NSP and Wildcards.

• CLIPTextEncode (NSP) and CLIPTextEncode (BlenderNeko Advanced + NSP): Assign variables with $|prompt words|$ format. You can then print this word again within the prompt with the number corresponding the order you created them. So the first prompt var would be printed with $1 and the second with $2 and so on.

Video Nodes

Codecs

You can use codecs that are available to your ffmpeg binaries by adding their fourcc ID (in one string), and appropriate container extension to the was_suite_config.json

Example H264 Codecs (Defaults)

    "ffmpeg_extra_codecs": {
        "avc1": ".mp4",
        "h264": ".mkv"
    }

Notes

• For now I am only supporting Windows installations for video nodes.
  • I do not have access to Mac or a stand-alone linux distro. If you get them working and want to PR a patch/directions, feel free.
• Video nodes require FFMPEG. You should download the proper FFMPEG binaries for you system and set the FFMPEG path in the config file.
• Additionally, if you want to use H264 codec need to download OpenH264 1.8.0 and place it in the root of ComfyUI (Example: C:\ComfyUI_windows_portable).
• FFV1 will complain about invalid container. You can ignore this. The resulting MKV file is readable. I have not figured out what this issue is about. Documentaion tells me to use MKV, but it's telling me it's unsupported.
  • If you know how to resolve this, I'd love a PR
• Write to Video node should use a lossless video codec or when it copies frames, and reapplies compression, it will start expontentially ruining the starting frames run to run.

Text Tokens

Text tokens can be used in the Save Text File and Save Image nodes. You can also add your own custom tokens with the Text Add Tokens node.

The token name can be anything excluding the : character to define your token. It can also be simple Regular Expressions.

Built-in Tokens

• [time]
  • The current system microtime
• [time(format_code)]
  • The current system time in human readable format. Utilizing datetime formatting
  • Example: [hostname]_[time]__[time(%Y-%m-%d__%I-%M%p)] would output: SKYNET-MASTER_16808972612023-04-0707-54PM
• [hostname]
  • The hostname of the system executing ComfyUI
• [cuda_device]
  • The cuda device from comfy.model_management.get_cuda_device()
• [cuda_name]
  • The cuda name from comfy.model_management.get_cuda_device_name()

Other Features

Import AUTOMATIC1111 WebUI Styles

When using the latest builds of WAS Node Suite a was_suite_config.json file will be generated (if it doesn't exist). In this file you can setup a A1111 styles import.

• Run ComfyUI to generate the new /custom-nodes/was-node-suite-comfyui/was_Suite_config.json file.
• Open the was_suite_config.json file with a text editor.
• Replace the webui_styles value from None to the path of your A1111 styles file called styles.csv. Be sure to use double backslashes for Windows paths.
  • Example C:\\python\\stable-diffusion-webui\\styles.csv
• Restart ComfyUI
• Select a style with the Prompt Styles Node.
  • The first ASCII output is your positive prompt, and the second ASCII output is your negative prompt.

You can set webui_styles_persistent_update to true to update the WAS Node Suite styles from WebUI every start of ComfyUI

Recommended Installation:

If you're running on Linux, or non-admin account on windows you'll want to ensure /ComfyUI/custom_nodes, was-node-suite-comfyui, and WAS_Node_Suite.py has write permissions.

There is now a install.bat you can run to install to portable if detected. Otherwise it will default to system and assume you followed ConfyUI's manual installation steps.

• Navigate to your /ComfyUI/custom_nodes/ folder
• Run git clone https://github.com/WASasquatch/was-node-suite-comfyui/
• Navigate to your was-node-suite-comfyui folder
  • Portable/venv:
    • Run path/to/ComfUI/python_embeded/python.exe -s -m pip install -r requirements.txt
  • With system python
    • Run pip install -r requirements.txt
• Start ComfyUI
  • WAS Suite should uninstall legacy nodes automatically for you.
  • Tools will be located in the WAS Suite menu.

Alternate [Legacy] Installation:

If you're running on Linux, or non-admin account on windows you'll want to ensure /ComfyUI/custom_nodes, and WAS_Node_Suite.py has write permissions.

• Download WAS_Node_Suite.py
• Move the file to your /ComfyUI/custom_nodes/ folder
• WAS Node Suite will attempt install dependencies on it's own, but you may need to manually do so. The dependencies required are in the requirements.txt on this repo. See installation steps above.
  • If this process fails attempt the following:
    • Navigate to your was-node-suite-comfyui folder
    • Portable/venv:
    • Run path/to/ComfUI/python_embeded/python.exe -s -m pip install -r requirements.txt
    • With system python
  • Run pip install -r requirements.txt
• Start, or Restart ComfyUI
  • WAS Suite should uninstall legacy nodes automatically for you.
  • Tools will be located in the WAS Suite menu.

This method will not install the resources required for Image Crop Face node, and you'll have to download the ./res/ folder yourself.

Installing on Colab

Create a new cell and add the following code, then run the cell. You may need to edit the path to your custom_nodes folder. You can also use the colab hosted here

• !git clone https://github.com/WASasquatch/was-node-suite-comfyui /content/ComfyUI/custom_nodes/was-node-suite-comfyui
• !pip install -r /content/ComfyUI/custom_nodes/was-node-suite-comfyui/requirements.txt
• Restart Colab Runtime (don't disconnect)
  • Tools will be located in the WAS Suite menu.