Comfy.ICU
ExploreDocsPricing
Support

ComfyUI Extension: ComfyUI-FlowChain

Authored by numz

Created

Updated

115 stars

Convert your workflows into node and chain them.

Custom Nodes (0)

    README

    ⛓️ Comfyui-FlowChain

    💡 Description

    This repository includes a set of custom nodes for ComfyUI that allow you to:

    • Convert your workflows into nodes
    • Chain your workflows together
    • Bonus: a node to integrate LipSync Studio v0.6 via API (third-party application)
    <img src="docs/assets/demo.gif" width="100%">

    🚀 All Nodes

    <img src="docs/assets/allnodes.png" width="100%">

    📖 Quick Index

    🤔 Why, when the 'convert to group node' option already exists?

    The idea came from the frustration users experienced with the many limitations and bugs in ComfyUI’s group nodes. While group nodes can seem useful for organizing nodes hierarchically, their actual use often leads to issues. Here are some of the major flaws I aimed to address:

    • Instability with primitive nodes: Primitive nodes are often dropped when grouped, making them ineffective in complex workflows.
    • Issues with dynamic nodes: Dynamic nodes, such as those with switches or conditional behaviors, tend to lose connections when grouped.
    • Incompatibility with ControlNet: When integrating ControlNet nodes into group nodes, the order of inputs and outputs is crucial to avoid reversing results.
    • Complex node maintenance: Managing nodes in ComfyUI can quickly become overwhelming, especially when you need to modify the same function multiple times.

    By solving these problems, my tool makes node management more intuitive, stable, and efficient, allowing you to focus on what matters: creating.

    🚀 Updates

    2025.03.23 First of all, I apologize for not maintaining the code regularly. ComfyUI has evolved significantly since my last version, so I've completely revised the code to ensure better integration with ComfyUI and avoid future issues.

    Features in this version:

    • 💪 No need to convert your workflows to API format anymore - you can use original workflows directly.
    • 💪 Better cache management
    • 🗑️ remove "import workflow", no longer usefull since working on standart workflow.

    Warning and know issue:

    • 🛑 old version will not be compatible, sorry about that
    • ⚠️ The word "seed" in input as "INT" will break the node so if you wan't use "seed" as input prefer to give a name like "seed_input" or whatever...

    2024.11.01 Initial version features : 1 Convert your workflows into nodes

    🔗 requirements

    • comfyui: Be sure to have a ComfyUI front-end version of at least 1.11.8. If not, update ComfyUI to the latest version. To find the front-end version, go to ComfyUI settings (the gear icon), click "About," and check the version at the top of the page.

    💻 Installation

    Method 1: Automatic Installation

    1. Go to the ComfyUI Manager and click Custom Nodes Manager.
    2. search for FlowChain and click Install.

    Method 2: Manual Installation

    1. Install Git
    2. Go to folder ..\ComfyUI\custom_nodes
    3. Run cmd.exe

      Windows:

      Variant 1: In folder click panel current path and input cmd and press Enter on keyboard

      Variant 2: Press on keyboard Windows+R, and enter cmd.exe open window cmd, enter cd /d your_path_to_custom_nodes, Enter on keyboard

    4. Then do :

    git clone https://github.com/numz/Comfyui-FlowChain.git

    After this command be created folder Comfyui-FlowChain

    1. Go to the folder:

    cd Comfyui-FlowChain

    1. Then do:

    pip install -r requirements.txt

    1. Run Comfyui...

    🕸️ Nodes:

    | | Name | Description | ComfyUI category | |:-------------------------------------------------:|:--------------------|:------------------------------------------------------------------------------------------------------------:|:----------------:| | <img src="docs/assets/workflow.png" width="100%"> | Workflow | Node that allows loading workflows. It will show Inputs and Outputs into the loaded Workflows | FlowChain ⛓️ | | <img src="docs/assets/Input.png" width="100%"> | Workflow Input | Node used to declare the inputs of your workflows. | FlowChain ⛓️ | | <img src="docs/assets/output.png" width="100%"> | Workflow Output | Node used to declare the outputs of your workflows. | FlowChain ⛓️ | | <img src="docs/assets/Continue.png" width="100%"> | Workflow Continue | Node to stop/Continue the workflow process. | FlowChain ⛓️ | | <img src="docs/assets/lipsync.png" width="100%"> | Workflow Lipsync | Extra Node to use LipSync Studio via API | FlowChain ⛓️ |

    🐍 Usage

    ⛓️ Workflow Node

    Illustration

    Select a workflow from the workflows dropdown menu. This list displays all compatible workflows saved in your ComfyUI user directory:

    ComfyUI\user\default\workflows

    For a workflow to be considered compatible, it must contain at least one "Workflow Input" or "Workflow Output" node. This ensures the workflow can properly interface with the FlowChain system.

    Note: After adding new workflows to this directory, you'll need to refresh the ComfyUI interface (press F5) to see them appear in the dropdown list. But once loaded, it will refresh the parent node automatically

    ⛓️ Input Node

    Illustration

    • Allow to declare inputs in your workflow.

    • Types available : "IMAGE", "MASK", "STRING", "INT", "FLOAT", "LATENT", "BOOLEAN", "CLIP", "CONDITIONING", "MODEL", "VAE"

    • Give a Name and select the type.

    • Default value is used when debugging your workflow or if you don't plug an input into the Workflow node.

    • Illustration

    ⛓️ Output Node

    Illustration

    • Allow to declare outputs in your workflow.
    • Types available : "IMAGE", "MASK", "STRING", "INT", "FLOAT", "LATENT", "BOOLEAN", "CLIP", "CONDITIONING", "MODEL", "VAE"
    • Give a Name and select the type.
    • Default value is used to connect the output.

    Illustration

    ⛓️ Continue Node

    Illustration

    • Usually associated with a boolean input plugged on "continue_workflow", allow to "Stop" a workflow if "continue_workflow" is False.
    • Types available : "IMAGE", "LATENT"
    • Give a Name and select the type.
    • During development of your workflow, If **continue_worflow" is False it will let pass only 1 image/latent, and if True it will let pass all images/latents.

    Illustration

    • But When a workflow is loaded into the "workflow" Node, which contain a "Workflow Continue" node, it will be delete if continue_workflow is False. That allow to create conditional situation where you want to prevent computation of some parts.

    Illustration

    🔉👄 Workflow LipSync Node

    Illustration

    • Extra Node that allow to use third-party app Lipsync Studio v0.6 Via it's API
    • Inputs:
      • frames: Images to compute.
      • audio: Audio to add.
      • faceswap_image: An image with a face to swap.
      • lipsync_studio_url: usually http://127.0.0.1:7860
      • project_name: name of your project.
      • face_id: id of the face you want to lipsync and faceswap.
      • fps: frame per second.
      • avatar: Will be used create a driving video, 10 avatars are available, each give different output result.
      • close mouth before Lip sync: Allow to close the mouth before create the lip sync.
      • quality: Can be Low, Medium, High, in High gfpgan will be used to enhance quality output.
      • skip_first_frame: number of frames to remove at the beginning of the video.
      • load_cap: number of frames to load.
      • low vram: allow to decrease VRAM consumption for low pc configuration.

    Project will be automatically created into your Lipsync Studio projects folder. You can then load it into studio and work directly from studio if the output not good enough for you.

    Illustration

    💪 Special things to know

    the "🪛 Switch" nodes from Crystools have a particular place in workflow Node

    Illustration

    Let's illustrate this with an example:

    Illustration

    Here we want to choose between video1 or video2. It depends on the boolean value in Switch Image Node. The issue here is that both videos will be loaded before Switch. To prevent both videos from being loaded, the "workflow node" will check the boolean value, remove the unused node, and directly connect the correct value to the preview image.

    Illustration

    This gives you the ability to create truly conditional cases in your workflows, without computing irrelevant nodes.

    📺 Examples

    Coming soon

    😎 Contributing

    We welcome contributions to this project. When submitting pull requests, please provide a detailed description of the changes. see CONTRIBUTING for more information.

    🙏 Appreciation

    • Jedrzej Kosinski : For the code quality that really inspired me during development.

    ☕ Support

    this project is open-source effort that is free to use and modify. I rely on the support of users to keep this project going and help improve it. If you'd like to support me, you can make a donation on my buy me a coffe or Patreon page. Any contribution, large or small, is greatly appreciated!

    Your support helps me cover the costs of development and maintenance, and allows me to allocate more time and resources to enhancing this project. Thank you for your support!

    patreon page

    📜 License

    • The code in this repository is released under the MIT license as found in the LICENSE file.