n8n-nodes-comfyui-all 2.1.0 â 2.1.2
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.
- package/README.md +9 -125
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,21 +3,18 @@
|
|
|
3
3
|
> n8n community node for integrating ComfyUI workflows into n8n automation platform.
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/n8n-nodes-comfyui-all)
|
|
6
|
-
[](https://opensource.org/licenses/MIT)
|
|
7
6
|
|
|
8
7
|
## âš Features
|
|
9
8
|
|
|
10
9
|
- đš **Universal Workflow Support** - Works with any ComfyUI workflow in API format
|
|
11
10
|
- đ **Dynamic Parameters** - Override workflow parameters dynamically
|
|
12
|
-
- đŹ **Multi-Modal
|
|
13
|
-
- đ **SSRF Protection** - Built-in security for private networks
|
|
11
|
+
- đŹ **Multi-Modal Support** - Supports images and videos for both input and output
|
|
14
12
|
- đ€ **AI Agent Ready** - Can be used as a tool in AI Agent workflows
|
|
15
13
|
- đ **Flexible Configuration** - JSON mode or single parameter mode
|
|
16
|
-
- đŒïž **Binary Data Support** - Upload input images to ComfyUI
|
|
17
14
|
|
|
18
15
|
## đŠ Installation
|
|
19
16
|
|
|
20
|
-
### n8n Cloud
|
|
17
|
+
### n8n Cloud
|
|
21
18
|
|
|
22
19
|
1. Go to **Settings** â **Community Nodes**
|
|
23
20
|
2. Click **Install**
|
|
@@ -27,15 +24,13 @@
|
|
|
27
24
|
### Self-Hosted n8n
|
|
28
25
|
|
|
29
26
|
```bash
|
|
30
|
-
# Via npm
|
|
31
27
|
cd ~/.n8n
|
|
32
28
|
npm install n8n-nodes-comfyui-all
|
|
33
|
-
|
|
34
|
-
# Or via n8n interface
|
|
35
|
-
# Settings â Community Nodes â Install â n8n-nodes-comfyui-all
|
|
36
29
|
```
|
|
37
30
|
|
|
38
|
-
|
|
31
|
+
Or via n8n interface: **Settings** â **Community Nodes** â **Install** â `n8n-nodes-comfyui-all`
|
|
32
|
+
|
|
33
|
+
> Restart n8n after installation.
|
|
39
34
|
|
|
40
35
|
## đ Quick Start
|
|
41
36
|
|
|
@@ -62,7 +57,7 @@ Restart n8n after installation.
|
|
|
62
57
|
### Basic Example: Text to Image
|
|
63
58
|
|
|
64
59
|
**Node Configuration:**
|
|
65
|
-
- **Action**: TextToAny
|
|
60
|
+
- **Action**: `TextToAny`
|
|
66
61
|
- **ComfyUI URL**: `http://127.0.0.1:8188`
|
|
67
62
|
- **Workflow JSON**: Your ComfyUI workflow in API format
|
|
68
63
|
|
|
@@ -72,9 +67,7 @@ Restart n8n after installation.
|
|
|
72
67
|
- Type: `Text`
|
|
73
68
|
- Value: `a beautiful landscape, high quality`
|
|
74
69
|
|
|
75
|
-
###
|
|
76
|
-
|
|
77
|
-
The node supports two parameter configuration modes:
|
|
70
|
+
### Parameter Configuration Modes
|
|
78
71
|
|
|
79
72
|
#### 1. Multiple Parameters Mode (JSON)
|
|
80
73
|
|
|
@@ -125,49 +118,7 @@ AI: I'll generate that for you using ComfyUI.
|
|
|
125
118
|
|
|
126
119
|
For detailed AI Agent usage, see [AI-AGENT-USAGE.md](AI-AGENT-USAGE.md).
|
|
127
120
|
|
|
128
|
-
##
|
|
129
|
-
|
|
130
|
-
### 1. Text to Image
|
|
131
|
-
|
|
132
|
-
Generate images from text descriptions.
|
|
133
|
-
|
|
134
|
-
### 2. Image to Image
|
|
135
|
-
|
|
136
|
-
Transform images with different styles.
|
|
137
|
-
|
|
138
|
-
### 3. Video Generation
|
|
139
|
-
|
|
140
|
-
Create videos using ComfyUI's video generation workflows.
|
|
141
|
-
|
|
142
|
-
### 4. Batch Processing
|
|
143
|
-
|
|
144
|
-
Process multiple images or generate multiple outputs.
|
|
145
|
-
|
|
146
|
-
## đ Output Format
|
|
147
|
-
|
|
148
|
-
The node returns binary data in n8n format:
|
|
149
|
-
|
|
150
|
-
```json
|
|
151
|
-
{
|
|
152
|
-
"success": true,
|
|
153
|
-
"imageCount": 1,
|
|
154
|
-
"videoCount": 0,
|
|
155
|
-
"data": {
|
|
156
|
-
"mimeType": "image/png",
|
|
157
|
-
"fileName": "ComfyUI_00001.png",
|
|
158
|
-
"data": "base64_encoded_image_data"
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
**Binary Output:**
|
|
164
|
-
- First output: `data` (for preview)
|
|
165
|
-
- Additional outputs: `image_0`, `image_1`, etc.
|
|
166
|
-
- Videos: `video_0`, `video_1`, etc.
|
|
167
|
-
|
|
168
|
-
## đ§ Configuration
|
|
169
|
-
|
|
170
|
-
### Node Parameters
|
|
121
|
+
## đ§ Configuration Reference
|
|
171
122
|
|
|
172
123
|
| Field | Description |
|
|
173
124
|
|-------|-------------|
|
|
@@ -177,77 +128,10 @@ The node returns binary data in n8n format:
|
|
|
177
128
|
| **Timeout** | Maximum wait time in seconds (default: 300) |
|
|
178
129
|
| **Node Parameters** | Override workflow parameters |
|
|
179
130
|
|
|
180
|
-
### Parameter Modes
|
|
181
|
-
|
|
182
|
-
| Mode | Best For | Input Type |
|
|
183
|
-
|------|----------|------------|
|
|
184
|
-
| **Multiple Parameters** | Bulk configuration | JSON object |
|
|
185
|
-
| **Single Parameter** | Individual parameters | Text/Number/Boolean/Binary |
|
|
186
|
-
|
|
187
|
-
## đ Troubleshooting
|
|
188
|
-
|
|
189
|
-
### Node not appearing in n8n
|
|
190
|
-
|
|
191
|
-
1. Check installation: `ls ~/.n8n/nodes/node_modules/ | grep comfyui`
|
|
192
|
-
2. Restart n8n service
|
|
193
|
-
3. Clear browser cache (Ctrl+Shift+R)
|
|
194
|
-
|
|
195
|
-
### Connection to ComfyUI failed
|
|
196
|
-
|
|
197
|
-
1. Verify ComfyUI is running: `curl http://127.0.0.1:8188/system_stats`
|
|
198
|
-
2. Check firewall settings
|
|
199
|
-
3. Ensure correct URL configuration
|
|
200
|
-
|
|
201
|
-
### Workflow validation failed
|
|
202
|
-
|
|
203
|
-
1. Ensure using **Save (API Format)** export
|
|
204
|
-
2. Validate JSON syntax
|
|
205
|
-
3. Check node IDs match your workflow
|
|
206
|
-
|
|
207
|
-
### Private network access denied
|
|
208
|
-
|
|
209
|
-
If you see "Cannot connect to private network addresses" error:
|
|
210
|
-
- This is n8n's SSRF protection
|
|
211
|
-
- For local ComfyUI: Use environment variable `N8N_ALLOW_NODES_SELF_REFERRAL=true`
|
|
212
|
-
- For remote ComfyUI: Ensure it's accessible from your n8n instance
|
|
213
|
-
|
|
214
|
-
## đ Additional Documentation
|
|
215
|
-
|
|
216
|
-
- **[AI Agent Usage Guide](AI-AGENT-USAGE.md)** - Detailed AI Agent integration guide
|
|
217
|
-
- **[Development Guide](DEVELOPMENT.md)** - Contributing and development setup
|
|
218
|
-
- **[Deployment Guide](DEPLOYMENT.md)** - Custom deployment for development
|
|
219
|
-
|
|
220
|
-
## đ„ Video Tutorials
|
|
221
|
-
|
|
222
|
-
Video tutorials coming soon!
|
|
223
|
-
đș [YouTube Playlist](https://youtube.com/playlist?list=PLxxxxx) (Coming Soon)
|
|
224
|
-
đș [Bilibili Playlist](https://space.bilibili.com/xxxxx) (ćłć°æšćș)
|
|
225
|
-
|
|
226
131
|
## đĄ Tips
|
|
227
132
|
|
|
228
133
|
- **First time**: Start with a simple text-to-image workflow
|
|
229
134
|
- **Parameter overrides**: Use Node Parameters instead of modifying workflow JSON
|
|
230
135
|
- **Seed control**: Fixed seeds produce reproducible results
|
|
231
136
|
- **Optimization**: 20-30 sampling steps are usually sufficient
|
|
232
|
-
- **Binary data**: Use Binary type to upload input images
|
|
233
|
-
|
|
234
|
-
## đ ïž Technical Stack
|
|
235
|
-
|
|
236
|
-
- TypeScript (strict mode)
|
|
237
|
-
- n8n-workflow SDK
|
|
238
|
-
- ComfyUI API integration
|
|
239
|
-
|
|
240
|
-
## đ License
|
|
241
|
-
|
|
242
|
-
MIT License - see [LICENSE](LICENSE) for details
|
|
243
|
-
|
|
244
|
-
## đ€ Contributing
|
|
245
|
-
|
|
246
|
-
Contributions are welcome! Please see [DEVELOPMENT.md](DEVELOPMENT.md) for guidelines.
|
|
247
|
-
|
|
248
|
-
---
|
|
249
|
-
|
|
250
|
-
**Author**: wwrs
|
|
251
|
-
**Repository**: [n8n-nodes-comfyui-all](https://github.com/wwrs/n8n-nodes-comfyui)
|
|
252
|
-
|
|
253
|
-
**Support**: For issues and questions, please use [GitHub Issues](https://github.com/wwrs/n8n-nodes-comfyui/issues)
|
|
137
|
+
- **Binary data**: Use Binary type to upload input images
|