comfyui-text-to-audio

Package Information

Released: 5/27/2025

Downloads: 636 weekly / 636 monthly

Latest Version: 1.1.0

Author: ksc1234

Available Nodes

ComfyUI Text to Audio

Generate audio from text using ComfyUI workflows

Documentation

Banner image

n8n-nodes-comfyui-text-to-audio

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
Generate audio from text 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 18 or newer

Installation

Standard Installation

# Install from npm package (recommended)
npm install n8n-nodes-comfyui-text-to-audio

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

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-text-to-audio.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-text-to-audio/

# 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-text-to-audio && \
    cp -r /tmp/node_modules/n8n-nodes-comfyui-text-to-audio /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-text-to-audio.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-text-to-audio
cp -r dist/* ./custom-nodes/n8n-nodes-comfyui-text-to-audio/

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

Node Types

ComfyUI Text to Audio Node

This node allows you to generate audio from text using ComfyUI's text-to-audio 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 text-to-audio generation
Input Type: Choose between Text Input or JSON Parameters
Text Input: Text to convert to audio (when using Text Input)
JSON Parameters: JSON object with advanced parameters (when using JSON Parameters input type)
Voice Model: Specify a voice model name (optional)
Timeout: Maximum time in minutes to wait for audio generation

Input

The node accepts text input in two ways:

Text Input: Provide direct text to be converted to audio
JSON Parameters: Provide a JSON object with text and additional parameters

Outputs

The node outputs the generated audio:

In the binary.data property with proper MIME type and file information
fileName: Name of the generated audio file
data: Base64 encoded audio data
fileType: The type of audio file (e.g., 'audio')
fileSize: Size of the audio in KB
fileExtension: File extension (wav, mp3, ogg, flac)
mimeType: MIME type of the audio

Usage Examples

Using the ComfyUI Text to Audio Node

Create a workflow in ComfyUI for text-to-audio generation
Export the workflow as JSON (API)
Add the ComfyUI Text to Audio node
Paste your workflow JSON
Select the appropriate Input Type:
- For Text Input: Enter the text to convert to audio
- For JSON Parameters: Provide a JSON object with 'text' and other parameters
Optionally specify a voice model
Configure timeout as needed
Execute the workflow to generate audio from your input text

Error Handling

The node includes comprehensive error handling for:

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

Development

# Install dependencies
npm install

# Build
npm run build

# Test
npm run test

# Lint
npm run lint

License

MIT

한국어 문서