n8n-nodes-comfyui-all 2.4.6 → 2.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +215 -471
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,373 +1,200 @@
1
1
  # n8n-nodes-comfyui-all
2
2
 
3
- > n8n community node for integrating ComfyUI workflows into n8n automation platform.
3
+ > Execute ComfyUI workflows in n8n - Generate images, videos, and more with AI!
4
4
 
5
5
  [![npm version](https://badge.fury.io/js/n8n-nodes-comfyui-all.svg)](https://www.npmjs.com/package/n8n-nodes-comfyui-all)
6
6
 
7
- ## 📖 Table of Contents
7
+ ## Video Tutorials
8
8
 
9
- - [Overview](#-overview)
10
- - [Installation](#-installation)
11
- - [Nodes Comparison](#-nodes-comparison)
12
- - [Quick Start](#-quick-start)
13
- - [ComfyUI Tool Node](#-comfyui-tool-node)
14
- - [ComfyUI Node](#-comfyui-node)
15
- - [Advanced Usage](#-advanced-usage)
16
- - [Troubleshooting](#-troubleshooting)
17
- - [Configuration Reference](#-configuration-reference)
9
+ - 📺 [YouTube Tutorial](https://youtu.be/wsbo3hBKsPM)
10
+ - 📺 [哔哩哔哩教程](https://www.bilibili.com/video/BV1ffrFBTEdQ/?vd_source=6485fe2fae664d8b09cb2e2fd7df5ef7)
18
11
 
19
- ## 🎯 Overview
12
+ ## What This Does
20
13
 
21
- This package provides two specialized nodes for integrating ComfyUI with n8n:
14
+ This package adds **two nodes** to n8n that let you run ComfyUI workflows:
22
15
 
23
- ### 🌟 Key Features
16
+ 1. **ComfyUI Tool** - For AI Agents (URL-based image input)
17
+ 2. **ComfyUI** - For standard workflows (supports binary & URL)
24
18
 
25
- - 🎨 **Universal Workflow Support** - Works with any ComfyUI workflow in API format
26
- - 🔄 **Dynamic Parameters** - Override workflow parameters at runtime
27
- - 🎬 **Multi-Modal Support** - Supports images and videos for both input and output
28
- - 🤖 **AI Agent Ready** - Optimized nodes for AI Agent and standard workflows
29
- - 📊 **Flexible Configuration** - JSON mode or single parameter mode
30
- - 🏷️ **Customizable Output** - Flexible output format (URLs or binary data)
19
+ You can use these nodes to:
20
+ - Generate images from text prompts
21
+ - Process and edit images
22
+ - Generate videos
23
+ - Use AI Agents to create images automatically
24
+ - And much more with any ComfyUI workflow!
31
25
 
32
26
  ---
33
27
 
34
- ## 📦 Installation
28
+ ## Quick Setup
35
29
 
36
- ### n8n Cloud
37
-
38
- 1. Go to **Settings** → **Community Nodes**
39
- 2. Click **Install**
40
- 3. Enter: `n8n-nodes-comfyui-all`
41
- 4. Click **Install**
42
-
43
- ### Self-Hosted n8n
30
+ ### 1. Install
44
31
 
45
32
  ```bash
33
+ # n8n Cloud: Settings → Community Nodes → Install → n8n-nodes-comfyui-all
34
+
35
+ # Self-hosted:
46
36
  cd ~/.n8n
47
37
  npm install n8n-nodes-comfyui-all
48
38
  ```
49
39
 
50
- Or via n8n interface: **Settings** → **Community Nodes** → **Install** → `n8n-nodes-comfyui-all`
51
-
52
- > ⚠️ **Restart n8n after installation**
53
-
54
- ---
55
-
56
- ## 🔍 Nodes Comparison
57
-
58
- ### Quick Reference
59
-
60
- | Feature | ComfyUI Tool 🤖 | ComfyUI 🔧 |
61
- |---------|----------------|------------|
62
- | **Primary Use Case** | AI Agent Workflows | Standard Workflows |
63
- | **Image Input** | URL only | Binary or URL |
64
- | **Binary Output** | ❌ No | ✅ Yes |
65
- | **URL Output** | ✅ Yes | ✅ Yes |
66
- | **Parameter Overrides** | ✅ Yes | ✅ Yes (Advanced) |
67
- | **LLM Context** | ✅ Lightweight (URLs only) | ⚠️ Not optimized |
68
- | **Node Configuration** | Simple | Advanced |
69
-
70
- ### Which Node Should I Use?
71
-
72
- ```
73
- ┌─────────────────────────────────────────────────────────────┐
74
- │ Your Scenario │
75
- └─────────────────────────────────────────────────────────────┘
76
- │
77
- ┌───────────────┴───────────────┐
78
- │ │
79
- Using AI Agent? Standard Workflow?
80
- │ │
81
- ▼ ▼
82
- ┌───────────────┐ ┌──────────────┐
83
- │ ComfyUI Tool │ │ ComfyUI │
84
- └───────────────┘ └──────────────┘
85
- │ │
86
- Image Input: URL Image Input:
87
- • Binary
88
- • URL
89
- ```
90
-
91
- #### Use ComfyUI Tool When:
92
- - ✅ Building AI Agent workflows
93
- - ✅ Integrating with chat interfaces
94
- - ✅ Processing images from URLs
95
- - ✅ Minimizing LLM token usage
96
- - ✅ Need simple URL-based configuration
97
-
98
- #### Use ComfyUI Node When:
99
- - ✅ Building standard n8n workflows
100
- - ✅ Processing binary data from previous nodes
101
- - ✅ Working with file uploads/webhooks
102
- - ✅ Need advanced parameter configuration
103
- - ✅ Want binary output for further processing
104
-
105
- ---
106
-
107
- ## 🚀 Quick Start
40
+ ### 2. Run ComfyUI
108
41
 
109
- ### Prerequisites
110
-
111
- - ✅ ComfyUI server running (default: `http://127.0.0.1:8188`)
112
- - ✅ n8n instance (version 2.x or higher)
113
- - ✅ Basic understanding of ComfyUI workflows
114
-
115
- ### 3-Step Setup
116
-
117
- #### 1. Create Your Workflow in ComfyUI
118
-
119
- ```
120
- In ComfyUI:
121
- 1. Design your workflow
122
- 2. Click "Save (API Format)"
123
- 3. Copy the generated JSON
124
- ```
125
-
126
- #### 2. Add Node to n8n
127
-
128
- ```
129
- In n8n:
130
- 1. Add either "ComfyUI Tool" or "ComfyUI" node
131
- 2. Paste your Workflow JSON
132
- 3. Configure ComfyUI URL
133
- 4. (Optional) Set up parameters
42
+ Make sure ComfyUI is running:
43
+ ```bash
44
+ # Default: http://127.0.0.1:8188
134
45
  ```
135
46
 
136
- #### 3. Execute
47
+ ### 3. Use in n8n
137
48
 
138
- ```
139
- Run your workflow and enjoy! 🎉
140
- ```
49
+ Add either **ComfyUI Tool** or **ComfyUI** node to your workflow!
141
50
 
142
51
  ---
143
52
 
144
- ## 🤖 ComfyUI Tool Node
145
-
146
- ### Overview
147
-
148
- **Optimized for AI Agent workflows** - URL-based image input, simple configuration, LLM-friendly.
149
-
150
- ### Why URL-Based Input?
151
-
152
- ```
153
- ❌ Base64 Image:
154
- - Size: ~100KB - 1MB per image
155
- - Tokens: ~130K - 1.3M tokens
156
- - Result: 💥 Explodes LLM context
157
-
158
- ✅ Image URL:
159
- - Size: ~100 bytes
160
- - Tokens: ~30 tokens
161
- - Result: ✅ Lightweight and efficient
162
- ```
53
+ ## ComfyUI Tool vs ComfyUI Node
163
54
 
164
- ### Configuration
55
+ ### ComfyUI Tool 🤖
165
56
 
166
- #### Basic Setup
57
+ **Use for: AI Agent workflows**
167
58
 
168
59
  ```
169
- ┌─────────────────────────────────────────────────┐
170
- │ ComfyUI Tool │
171
- ├─────────────────────────────────────────────────┤
172
- │ ComfyUI URL: http://127.0.0.1:8188 │
173
- │ Workflow JSON: [Your ComfyUI workflow] │
174
- │ Timeout: 300 │
175
- │ Load Image Node ID: │
176
- │ (for image workflows) │
177
- │ Image URL: [URL or {{ $json.imageUrl }}] │
178
- └─────────────────────────────────────────────────┘
60
+ Example:
61
+ [Chat Input] → [AI Agent] → [ComfyUI Tool]
179
62
  ```
180
63
 
181
- #### Parameters
64
+ **Features:**
65
+ - ✅ Simple URL-based image input
66
+ - ✅ Works great with AI Agents
67
+ - ✅ Doesn't bloat LLM context (URLs are small!)
68
+ - ✅ Automatic image download
182
69
 
183
- | Parameter | Description | Example |
184
- |-----------|-------------|---------|
185
- | **ComfyUI URL** | ComfyUI server address | `http://127.0.0.1:8188` |
186
- | **Workflow JSON** | ComfyUI workflow in API format | `{ "3": {...} }` |
187
- | **Timeout** | Max wait time (seconds) | `300` (5 min) |
188
- | **Load Image Node ID** | LoadImage node ID for image workflows | `107` |
189
- | **Image URL** | URL of image to process | `https://...` |
190
- | **Parameter Overrides** | Override workflow parameters | See below |
191
-
192
- ### Output Format
70
+ **How to use:**
71
+ 1. Add to AI Agent as a tool
72
+ 2. Set ComfyUI URL
73
+ 3. Paste your ComfyUI workflow JSON
74
+ 4. Set Load Image Node ID (if using images)
75
+ 5. Pass image URL: `{{ $json.imageUrl }}`
193
76
 
77
+ **Example:**
194
78
  ```json
195
79
  {
196
- "success": true,
197
- "imageUrls": [
198
- "http://127.0.0.1:8188/view?filename=ComfyUI_00001.png"
199
- ],
200
- "videoUrls": [],
201
- "imageCount": 1,
202
- "videoCount": 0
80
+ "imageUrl": "https://example.com/image.png",
81
+ "prompt": "Transform to oil painting"
203
82
  }
204
83
  ```
205
84
 
206
- ### AI Agent Integration Example
207
-
208
- ```
209
- Workflow:
210
- [Chat Input] → [AI Agent] → [ComfyUI Tool]
211
- ↓
212
- Passes imageUrl
213
- ↓
214
- Downloads image
215
- ↓
216
- Processes in ComfyUI
217
- ↓
218
- Returns result URLs
219
- ```
220
-
221
- **Chat Example:**
222
-
223
- ```
224
- User: Transform this image (https://example.com/photo.png)
225
- to oil painting style
226
-
227
- AI Agent:
228
- 1. Extracts URL from message
229
- 2. Calls ComfyUI Tool
230
- 3. ComfyUI Tool downloads image
231
- 4. Processes in ComfyUI
232
- 5. Returns result URLs
233
- 6. AI Agent shows result to user
234
- ```
235
-
236
85
  ---
237
86
 
238
- ## 🔧 ComfyUI Node
87
+ ### ComfyUI Node 🔧
239
88
 
240
- ### Overview
241
-
242
- **Full-featured node for standard workflows** - Supports binary and URL inputs with advanced configuration.
243
-
244
- ### Configuration
245
-
246
- #### Basic Setup
89
+ **Use for: Standard n8n workflows**
247
90
 
248
91
  ```
249
- ┌─────────────────────────────────────────────────┐
250
- │ ComfyUI │
251
- ├─────────────────────────────────────────────────┤
252
- │ ComfyUI URL: http://127.0.0.1:8188 │
253
- │ Workflow JSON: [Your ComfyUI workflow] │
254
- │ Timeout: 300 │
255
- │ Output Binary Key: data │
256
- ├─────────────────────────────────────────────────┤
257
- │ Node Parameters: │
258
- │ [Multiple parameter configurations] │
259
- └─────────────────────────────────────────────────┘
92
+ Example:
93
+ [HTTP Request] → [ComfyUI] → [Save File]
260
94
  ```
261
95
 
262
- #### Parameters
263
-
264
- | Parameter | Description | Example |
265
- |-----------|-------------|---------|
266
- | **ComfyUI URL** | ComfyUI server address | `http://127.0.0.1:8188` |
267
- | **Workflow JSON** | ComfyUI workflow in API format | `{ "3": {...} }` |
268
- | **Timeout** | Max wait time (seconds) | `300` (5 min) |
269
- | **Output Binary Key** | First output binary property name | `data`, `image` |
270
- | **Node Parameters** | Override workflow parameters | See below |
96
+ **Features:**
97
+ - ✅ Supports binary data (from previous nodes)
98
+ - ✅ Supports URL download
99
+ - ✅ Advanced parameter configuration
100
+ - ✅ Binary output for further processing
271
101
 
272
- ### Image Input Methods
273
-
274
- #### Method 1: Binary Data
102
+ **How to use:**
275
103
 
104
+ **Option 1: Binary Input**
276
105
  ```
106
+ ComfyUI URL: http://127.0.0.1:8188
107
+ Workflow JSON: [Your workflow]
108
+
277
109
  Node Parameters:
278
110
  Node ID: 107
279
- Parameter Mode: Single Parameter
280
- Parameter Name: image
281
111
  Type: Image
282
- Image Input Type: Binary ← Binary mode
112
+ Image Input Type: Binary
283
113
  Value: data
284
114
  ```
285
115
 
286
- **Use when:** Previous node outputs binary data (HTTP Request, Webhook, etc.)
287
-
288
- #### Method 2: URL
289
-
116
+ **Option 2: URL Input**
290
117
  ```
118
+ ComfyUI URL: http://127.0.0.1:8188
119
+ Workflow JSON: [Your workflow]
120
+
291
121
  Node Parameters:
292
122
  Node ID: 107
293
- Parameter Mode: Single Parameter
294
- Parameter Name: image
295
123
  Type: Image
296
- Image Input Type: URL ← URL mode
124
+ Image Input Type: URL
297
125
  Image URL: https://example.com/image.png
298
126
  ```
299
127
 
300
- **Use when:** Downloading from web or using URL
301
-
302
- ### Output Format
303
-
304
- ```json
305
- {
306
- "json": {
307
- "success": true,
308
- "imageCount": 1,
309
- "imageUrls": ["http://..."],
310
- "data": { ... }
311
- },
312
- "binary": {
313
- "data": {
314
- "data": "base64...",
315
- "mimeType": "image/png",
316
- "fileName": "ComfyUI_00001.png"
317
- }
318
- }
319
- }
128
+ **Option 3: Text Input**
129
+ ```
130
+ Node Parameters:
131
+ Node ID: 6
132
+ Type: Text
133
+ Value: {{ $json.prompt }}
320
134
  ```
321
135
 
322
136
  ---
323
137
 
324
- ## 📚 Advanced Usage
138
+ ## Common Workflows
325
139
 
326
- ### 1. Text-to-Image with Dynamic Prompts
327
-
328
- **ComfyUI Node Setup:**
140
+ ### 1. Generate Image from Text
329
141
 
142
+ **Setup:**
330
143
  ```
331
- Node Parameters:
332
- Node ID: 6 (CLIP Text Encode)
333
- Parameter Mode: Single Parameter
334
- Parameter Name: text
335
- Type: Text
336
- Value: {{ $json.prompt }}
144
+ ComfyUI Node:
145
+ ComfyUI URL: http://127.0.0.1:8188
146
+ Workflow JSON: [Text-to-Image workflow]
147
+
148
+ Node Parameters:
149
+ Node ID: 6 (your CLIP Text node)
150
+ Type: Text
151
+ Value: {{ $json.prompt }}
337
152
  ```
338
153
 
339
154
  **Input:**
340
155
  ```json
156
+ { "prompt": "a beautiful sunset over mountains" }
157
+ ```
158
+
159
+ **Output:**
160
+ ```json
341
161
  {
342
- "prompt": "a beautiful landscape at sunset"
162
+ "imageUrls": ["http://127.0.0.1:8188/view?filename=image.png"]
343
163
  }
344
164
  ```
345
165
 
346
- ### 2. Image-to-Image Processing
166
+ ---
347
167
 
348
- **ComfyUI Tool Setup:**
168
+ ### 2. Process Image with AI Agent
349
169
 
170
+ **Workflow:**
350
171
  ```
172
+ [Chat Interface] → [AI Agent] → [ComfyUI Tool]
173
+ ```
174
+
175
+ **ComfyUI Tool Setup:**
176
+ ```
177
+ ComfyUI URL: http://127.0.0.1:8188
178
+ Workflow JSON: [Image-to-Image workflow]
351
179
  Load Image Node ID: 107
352
180
  Image URL: {{ $json.imageUrl }}
353
- Parameter Overrides:
354
- - Node ID: 6
355
- Param Path: inputs.text
356
- Value: {{ $json.prompt }}
357
181
  ```
358
182
 
359
- **Input:**
360
- ```json
361
- {
362
- "imageUrl": "https://example.com/input.png",
363
- "prompt": "Transform to oil painting style"
364
- }
183
+ **Chat:**
365
184
  ```
185
+ You: Transform this image https://example.com/photo.png
186
+ to watercolor style
366
187
 
367
- ### 3. Multiple Parameters Override
188
+ AI: I'll transform that image for you!
189
+ [Downloads image, processes in ComfyUI]
190
+ Done! Here's your watercolor image 🎨
191
+ ```
368
192
 
369
- **ComfyUI Node Setup:**
193
+ ---
194
+
195
+ ### 3. Edit Image with Parameters
370
196
 
197
+ **ComfyUI Node Setup:**
371
198
  ```
372
199
  Node Parameters:
373
200
  Node ID: 3
@@ -376,15 +203,15 @@ Node Parameters:
376
203
  {
377
204
  "width": 1024,
378
205
  "height": 1024,
379
- "steps": 30,
380
- "cfg": 7.5,
381
- "seed": 123456
206
+ "steps": 30
382
207
  }
383
208
  ```
384
209
 
385
- ### 4. Video Generation
210
+ ---
211
+
212
+ ### 4. Generate Video
386
213
 
387
- **Setup:** Similar to image generation, just use a video workflow in ComfyUI.
214
+ Same as image generation, just use a video workflow in ComfyUI!
388
215
 
389
216
  **Output:**
390
217
  ```json
@@ -396,243 +223,160 @@ Node Parameters:
396
223
 
397
224
  ---
398
225
 
399
- ## 🤖 AI Agent Workflows
400
-
401
- ### Example 1: Image Generation Chat
402
-
403
- ```
404
- Workflow:
405
- [Chat Interface] → [AI Agent] → [ComfyUI Tool]
226
+ ## How to Get Your Workflow JSON
406
227
 
407
- Configuration:
408
- - Model: GPT-4
409
- - Tools: ComfyUI Tool
410
- - Workflow: Text-to-Image
228
+ 1. Open ComfyUI
229
+ 2. Create or load your workflow
230
+ 3. Click **"Save (API Format)"** (not "Save")
231
+ 4. Copy the JSON
232
+ 5. Paste it in the node's **Workflow JSON** field
411
233
 
412
- Conversation:
413
- User: "Generate a picture of a cute cat"
414
- AI: [Calls ComfyUI Tool]
415
- AI: "Here's your image! 😊"
416
- ```
417
-
418
- ### Example 2: Image Editing
234
+ ---
419
235
 
420
- ```
421
- Workflow:
422
- [Chat Interface] → [AI Agent] → [ComfyUI Tool]
236
+ ## Parameters Explained
423
237
 
424
- Configuration:
425
- - ComfyUI Tool:
426
- - Workflow: Image-to-Image
427
- - Load Image Node ID: 107
428
- - Image URL: {{ $json.imageUrl }}
238
+ ### ComfyUI Tool Node
429
239
 
430
- Conversation:
431
- User: "Transform this image (URL) to watercolor style"
432
- AI: [Extracts URL, downloads image, processes in ComfyUI]
433
- AI: "Done! Here's the watercolor version 🎨"
434
- ```
240
+ | Parameter | What It Does | Example |
241
+ |-----------|--------------|---------|
242
+ | **ComfyUI URL** | Where ComfyUI is running | `http://127.0.0.1:8188` |
243
+ | **Workflow JSON** | Your ComfyUI workflow (API format) | `{...}` |
244
+ | **Timeout** | Max wait time (seconds) | `300` |
245
+ | **Load Image Node ID** | Which LoadImage node to use | `107` |
246
+ | **Image URL** | URL of image to process | `https://...` |
247
+ | **Parameter Overrides** | Change workflow values | See below |
435
248
 
436
- ### Example 3: Multi-Modal Workflow
249
+ ### ComfyUI Node
437
250
 
438
- ```
439
- Workflow:
440
- [Chat Input] → [AI Agent] → [ComfyUI Tool] → [Chat Model]
441
- ↓ ↓
442
- Generate Image Write Poem
443
- ↓ ↓
444
- Return Combined Result
251
+ | Parameter | What It Does | Example |
252
+ |-----------|--------------|---------|
253
+ | **ComfyUI URL** | Where ComfyUI is running | `http://127.0.0.1:8188` |
254
+ | **Workflow JSON** | Your ComfyUI workflow (API format) | `{...}` |
255
+ | **Timeout** | Max wait time (seconds) | `300` |
256
+ | **Output Binary Key** | Name for output binary | `data` |
257
+ | **Node Parameters** | Configure workflow parameters | See below |
445
258
 
446
- Conversation:
447
- User: "Create an image of a futuristic city
448
- and write a poem about it"
259
+ ### Node Parameters
449
260
 
450
- AI: [1. Generates image via ComfyUI Tool]
451
- [2. Writes poem about the image]
452
- [3. Returns both to user]
453
- ```
261
+ | Field | What It Does |
262
+ |-------|--------------|
263
+ | **Node ID** | The ComfyUI node to change (e.g., "6", "13") |
264
+ | **Parameter Mode** | "Single" for one parameter, "Multiple" for JSON |
265
+ | **Type** | Text, Number, Boolean, or Image |
266
+ | **Value** | The value to set |
454
267
 
455
268
  ---
456
269
 
457
- ## ⚙️ Best Practices
270
+ ## Tips & Tricks
458
271
 
459
- ### 1. URL Selection
272
+ ### ✅ Use URLs with AI Agents
460
273
 
461
- ✅ **Good:**
462
- ```
463
- https://cdn.example.com/images/photo.png
464
- https://storage.googleapis.com/bucket/image.jpg
465
- https://s3.amazonaws.com/bucket/photo.png
274
+ URLs are much smaller than base64 images:
466
275
  ```
276
+ Base64: ~100KB - 1MB per image
277
+ URL: ~100 bytes
467
278
 
468
- ❌ **Avoid:**
469
- ```
470
- file:///local/path/image.png ← Not accessible
471
- http://localhost:8080/image.png ← Private network
279
+ Better for LLM context and costs!
472
280
  ```
473
281
 
474
- ### 2. Parameter Naming
282
+ ### ✅ Find Your Node ID
475
283
 
476
- ✅ **Use Clear Names:**
477
- ```
478
- Node ID: 6
479
- Parameter Name: text ← Matches ComfyUI node input
480
- ```
481
-
482
- ❌ **Vague Names:**
483
- ```
484
- Node ID: node_6
485
- Parameter Name: param1 ← Unclear what it does
284
+ Open your workflow JSON and look for:
285
+ ```json
286
+ {
287
+ "6": {
288
+ "inputs": {...},
289
+ "class_type": "KSampler"
290
+ }
291
+ }
486
292
  ```
293
+ The `"6"` is your Node ID!
487
294
 
488
- ### 3. Timeout Settings
489
-
490
- ```
491
- Simple workflows: 60-120 seconds
492
- Complex workflows: 300-600 seconds
493
- Video generation: 600-1800 seconds
494
- ```
295
+ ### ✅ Test First
495
296
 
496
- ### 4. Error Handling
297
+ Always test your workflow in ComfyUI before using it in n8n!
497
298
 
498
- ```javascript
499
- // Always validate inputs
500
- if (!workflowJson) {
501
- throw new Error('Workflow JSON is required');
502
- }
299
+ ### ✅ Use Appropriate Timeouts
503
300
 
504
- // Check ComfyUI server availability
505
- // Use appropriate timeouts
506
- // Handle network errors gracefully
301
+ ```
302
+ Simple workflows: 60-120 seconds
303
+ Complex workflows: 300-600 seconds
304
+ Video generation: 600-1800 seconds
507
305
  ```
508
306
 
509
307
  ---
510
308
 
511
- ## 🔧 Troubleshooting
512
-
513
- ### Common Issues
514
-
515
- #### ❌ "Invalid ComfyUI URL"
516
-
517
- **Solution:**
518
- - Check ComfyUI is running
519
- - Verify URL format: `http://127.0.0.1:8188`
520
- - Try accessing ComfyUI in browser first
521
-
522
- #### ❌ "Workflow execution timeout"
523
-
524
- **Solutions:**
525
- - Increase timeout value
526
- - Check workflow complexity
527
- - Verify ComfyUI server performance
528
- - Check ComfyUI logs for errors
309
+ ## Troubleshooting
529
310
 
530
- #### ❌ "Node ID not found in workflow"
311
+ ### "Invalid ComfyUI URL"
312
+ Make sure ComfyUI is running and URL is correct: `http://127.0.0.1:8188`
531
313
 
532
- **Solutions:**
533
- - Open workflow JSON
534
- - Find the correct node ID
535
- - Note: IDs are strings like "6", "13", not numbers
314
+ ### "Workflow execution timeout"
315
+ Increase the timeout value in node settings
536
316
 
537
- #### ❌ "Failed to download image from URL"
317
+ ### "Node ID not found"
318
+ Check your workflow JSON - Node IDs are strings like "6", not numbers
538
319
 
539
- **Solutions:**
540
- - Verify URL is publicly accessible
541
- - Check URL doesn't require authentication
542
- - Ensure URL returns image (not HTML)
543
- - Test URL in browser first
320
+ ### "Failed to download image"
321
+ Make sure the URL is public and accessible (not localhost or file://)
544
322
 
545
- #### ❌ "AI Agent doesn't call ComfyUI"
546
-
547
- **Solutions:**
548
- - Ensure ComfyUI Tool is added to Agent's tools
549
- - Check tool description is clear
550
- - Verify workflow JSON is configured
551
- - Check Agent logs
323
+ ### "AI Agent doesn't call ComfyUI"
324
+ - Make sure ComfyUI Tool is added to Agent's tools
325
+ - Check the workflow JSON is set
326
+ - Try being more specific in your chat
552
327
 
553
328
  ---
554
329
 
555
- ## 📖 Configuration Reference
556
-
557
- ### ComfyUI Tool Node
330
+ ## Examples
558
331
 
559
- | Field | Type | Required | Default | Description |
560
- |-------|------|----------|---------|-------------|
561
- | **ComfyUI URL** | String | ✅ | `http://127.0.0.1:8188` | ComfyUI server address |
562
- | **Workflow JSON** | String | ✅ | - | ComfyUI workflow in API format |
563
- | **Timeout** | Number | ❌ | `300` | Max wait time (seconds) |
564
- | **Load Image Node ID** | String | ❌ | - | LoadImage node ID for image workflows |
565
- | **Image URL** | String | ❌ | - | URL of image to process |
566
- | **Parameter Overrides** | Collection | ❌ | - | Override workflow parameters |
567
-
568
- ### ComfyUI Node
332
+ ### Example 1: Simple Text to Image
569
333
 
570
- | Field | Type | Required | Default | Description |
571
- |-------|------|----------|---------|-------------|
572
- | **ComfyUI URL** | String | ✅ | `http://127.0.0.1:8188` | ComfyUI server address |
573
- | **Workflow JSON** | String | ✅ | - | ComfyUI workflow in API format |
574
- | **Timeout** | Number | ❌ | `300` | Max wait time (seconds) |
575
- | **Output Binary Key** | String | ❌ | `data` | First output binary property name |
576
- | **Node Parameters** | Collection | ❌ | - | Override workflow parameters |
577
-
578
- ### Node Parameter Fields
579
-
580
- | Field | Description | Options |
581
- |-------|-------------|---------|
582
- | **Node ID** | Node ID from workflow JSON | e.g., `6`, `13`, `107` |
583
- | **Parameter Mode** | How to configure parameters | Single / Multiple |
584
- | **Type** | Parameter data type | Text / Number / Boolean / Image |
585
- | **Image Input Type** | How to input image (when Type=Image) | Binary / URL |
586
- | **Parameter Name** | Parameter to override (single mode) | e.g., `text`, `seed`, `steps` |
587
- | **Parameters JSON** | JSON object with parameters (multiple mode) | `{"width": 1024}` |
588
- | **Value** | Value to set | Text / Number / Boolean |
589
-
590
- ---
334
+ ```
335
+ [Manual Trigger] → [ComfyUI] → [Save to File]
591
336
 
592
- ## 💡 Tips
337
+ ComfyUI Node:
338
+ Workflow: Text-to-Image
339
+ Node ID: 6
340
+ Type: Text
341
+ Value: a cute cat in a garden
342
+ ```
593
343
 
594
- ### 🎯 Performance
344
+ ### Example 2: AI Image Generator
595
345
 
596
- - Start with simple workflows to test setup
597
- - Use appropriate timeout values
598
- - Monitor ComfyUI resource usage
599
- - Use specific prompts for better results
346
+ ```
347
+ [Chat Trigger] → [AI Agent + ComfyUI Tool] → [Display Image]
600
348
 
601
- ### 🔒 Security
349
+ Agent says: "Generate a picture of..."
350
+ Calls: ComfyUI Tool
351
+ Returns: Image URL
352
+ Shows: Result to user
353
+ ```
602
354
 
603
- - Don't expose ComfyUI server publicly
604
- - Use secure URLs for images
605
- - Validate user inputs in production
606
- - Keep workflow JSON private if needed
355
+ ### Example 3: Batch Process Images
607
356
 
608
- ### 📝 Workflow Design
357
+ ```
358
+ [Spreadsheet] → [Loop] → [ComfyUI] → [Save]
609
359
 
610
- - Document your ComfyUI workflows
611
- - Use consistent node IDs
612
- - Test workflows in ComfyUI first
613
- - Keep workflows simple and modular
360
+ For each row:
361
+ - Get image URL
362
+ - Process in ComfyUI
363
+ - Save result
364
+ ```
614
365
 
615
366
  ---
616
367
 
617
- ## 🤝 Contributing
368
+ ## Need Help?
618
369
 
619
- Contributions are welcome! Please feel free to submit issues or pull requests.
370
+ - 📖 [n8n Documentation](https://docs.n8n.io)
371
+ - 💬 [n8n Community](https://community.n8n.io)
372
+ - 🐛 [Report Issues](https://github.com/your-repo/issues)
620
373
 
621
- ## 📄 License
622
-
623
- MIT License - see LICENSE file for details
374
+ ---
624
375
 
625
- ## 🙏 Acknowledgments
376
+ ## License
626
377
 
627
- - [ComfyUI](https://github.com/comfyanonymous/ComfyUI) - Powerful UI for Stable Diffusion
628
- - [n8n](https://n8n.io) - Workflow automation tool
378
+ MIT
629
379
 
630
380
  ---
631
381
 
632
- **Need Help?**
633
-
634
- - 📖 Check the [Documentation](https://docs.n8n.io)
635
- - 💬 Join the [Community](https://community.n8n.io)
636
- - 🐛 Report [Issues](https://github.com/your-repo/issues)
637
-
638
- **Happy Automating! 🚀**
382
+ **Happy automating with ComfyUI! 🚀**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "n8n-nodes-comfyui-all",
3
- "version": "2.4.6",
3
+ "version": "2.4.7",
4
4
  "description": "n8n community nodes for ComfyUI workflow execution with dynamic parameter support",
5
5
  "keywords": [
6
6
  "n8n-community-node-package",