ComfyUI-Blender

This respository contains both custom nodes to be installed on the ComfyUI server and the Blender add-on to send workflows to the ComfyUI server. They can be used as follow:

• Create a workflow in ComfyUI with the Blender nodes.
• Run the workflow to confirm it executes properly.
• Export the workflow in API format.
• Import the workflow in the Blender add-on

The Blender add-on UI is automatically generated according to the input and output nodes used in the workflow.

Setup

ComfyUI Setup

Download and install ComfyUI. Make sure you have the latest version. At the time of writing this, the latest version was ComfyUI v0.3.57. That version of ComfyUI required to update some of the ComfyUI-Blender nodes to the custom node schema v3. Making them incompatible with earlier versions of ComfyUI.

If you are new to ComfyUI, refer to the original ComfyUI repository to get started.

Install the ComfyUI-Blender nodes from the ComfyUI-Manager or by cloning this repository in the custom nodes folder of ComfyUI:

cd ./ComfyUI/custom_nodes
git clone https://github.com/alexisrolland/ComfyUI-Blender.git

If the ComfyUI server runs on a different machine than the Blender client, it must be started with the argument --listen. See ComfyUI documentation: Setting Up LAN Access for ComfyUI.

Install Blender Add-on

Make sure you have a recent version of Blender. The add-on has been developed for Blender v4.5 and above. Some features such as the lineart rendering do not work on earlier versions.

Download the add-on package comfyui_blender_[...].zip from the LATEST RELEASE.

In Blender, go to Edit > Preferences > Add-ons > Install from Disk > select the zip package.

Update the ComfyUI server address in the add-on preferences:

Usage

For complete details about the various features, refer to the DOCUMENTATION.

In a nutshell:

1. In ComfyUI, create a workflow using the Blender nodes (see workflow examples in this repository).

   • The Blender nodes are used to define the inputs and outputs to be displayed in the Blender add-on.
   • The title of the nodes are used as labels in the Blender add-on panel.

2. Run the workflow to confirm it executes properly.

3. Export the workflow JSON file in API format: Top Left Menu > File > Export (API).

4. In Blender, import the workflow JSON file (make sure it is in API format): Press N > ComfyUI > Import Workflow.

5. Update the inputs and click on Run Workflow.