comfyui-image-to-image

Package Information

Released: 5/27/2025

Downloads: 162 weekly / 320 monthly

Latest Version: 1.0.1

Author: ksc1234

Available Nodes

ComfyUI Image to Image

Transform images using ComfyUI workflow

Documentation

Banner image

n8n-nodes-comfyui-image-to-image

This package provides n8n node to integrate with ComfyUI - A powerful and modular stable diffusion GUI with a graph/nodes interface.

Features

Execute ComfyUI workflows directly from n8n
Transform images using stable diffusion models
Support for workflow JSON import
Automatic output retrieval from workflow outputs
Progress monitoring and error handling
Support for API key authentication
Configurable timeout settings

Prerequisites

n8n (version 1.0.0 or later)
ComfyUI instance running and accessible
Node.js 16 or newer

Installation

Standard Installation

# Install from npm package (recommended)
npm install [email protected]

# Or install from git repository
npm install github:StudioExitt/n8n-nodes-comfyui-image-to-image

Docker Installation

For Docker installations, you can use one of the following methods:

Method 1: Volume Mount

# Create a directory for custom nodes
mkdir -p /path/to/custom/nodes

# Clone the repository
git clone https://github.com/StudioExitt/n8n-nodes-comfyui-image-to-image.git /tmp/custom-nodes
cd /tmp/custom-nodes

# Install dependencies and build
npm install
npm run build

# Copy the built files to your custom nodes directory
cp -r dist/* /path/to/custom/nodes/n8n-nodes-comfyui-image-to-image/

# Run n8n with the custom nodes directory mounted
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v /path/to/custom/nodes:/home/node/.n8n/custom/nodes \
  n8nio/n8n

Method 2: Custom Docker Image

# Dockerfile
FROM n8nio/n8n

# Install the custom nodes package from GitHub
RUN cd /tmp && \
    npm install github:StudioExitt/n8n-nodes-comfyui-image-to-image && \
    cp -r /tmp/node_modules/n8n-nodes-comfyui-image-to-image /home/node/.n8n/custom/nodes/ && \
    chown -R node:node /home/node/.n8n

Build and run:

docker build -t n8n-with-comfyui .
docker run -d --name n8n -p 5678:5678 n8n-with-comfyui

Method 3: Docker Compose

version: '3'

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
      - ./custom-nodes:/home/node/.n8n/custom/nodes
    environment:
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production

volumes:
  n8n_data:

Then:

# Clone the repository
git clone https://github.com/StudioExitt/n8n-nodes-comfyui-image-to-image.git /tmp/custom-nodes
cd /tmp/custom-nodes

# Install dependencies and build
npm install
npm run build

# Copy the built files to your custom nodes directory
mkdir -p ./custom-nodes/n8n-nodes-comfyui-image-to-image
cp -r dist/* ./custom-nodes/n8n-nodes-comfyui-image-to-image/

# Start the docker-compose setup
docker-compose up -d

Node Types

ComfyUI Image to Image Node

This node allows you to convert images using ComfyUI's image-to-image capabilities.

Settings

API URL: The URL of your ComfyUI instance (default: http://127.0.0.1:8188)
API Key: Optional API key if authentication is enabled
Workflow JSON: The ComfyUI workflow in JSON format for image transformation
Input Type: Choose between URL, Base64, or Binary input methods
Input Image: URL or base64 string of the input image (when using URL or Base64 input type)
Binary Property: Name of the binary property containing the image (when using Binary input type)
Timeout: Maximum time in minutes to wait for image transformation

Input

The node accepts an image input in three ways:

URL: Provide a direct URL to an image
Base64: Provide a base64-encoded image string
Binary: Use an image from a binary property in the workflow (e.g., from an HTTP Request node)

Outputs

The node outputs the transformed image:

In the binary.data property with proper MIME type and file information
fileName: Name of the transformed image file
data: Base64 encoded image data
fileType: The type of image file (e.g., 'image')
fileSize: Size of the image in KB
fileExtension: File extension (png, jpg, webp)
mimeType: MIME type of the image

Usage Examples

Using the ComfyUI Image to Image Node

Create a workflow in ComfyUI for image transformation (e.g., img2img, inpainting, style transfer)
Export the workflow as JSON (API)
Add the ComfyUI Image to Image node
Paste your workflow JSON
Select the appropriate Input Type:
- For URL: Enter the image URL
- For Base64: Provide a base64 string
- For Binary: Specify the binary property containing the image (default: "data")
Configure timeout as needed
Execute the workflow to generate a transformed image from your input image

Error Handling

The node includes comprehensive error handling for:

API connection issues
Invalid workflow JSON
Execution failures
Timeout conditions
Input image validation

Development

# Install dependencies
npm install

# Build
npm run build

# Test
npm run test

# Lint
npm run lint

License

MIT

한국어 문서