n8n-nodes-comfyui-all 2.4.3 → 2.4.6

package/README.md

@@ -4,15 +4,32 @@
 
 [![npm version](https://badge.fury.io/js/n8n-nodes-comfyui-all.svg)](https://www.npmjs.com/package/n8n-nodes-comfyui-all)
 
-## ✨ Features
+## 📖 Table of Contents
+
+- [Overview](#-overview)
+- [Installation](#-installation)
+- [Nodes Comparison](#-nodes-comparison)
+- [Quick Start](#-quick-start)
+- [ComfyUI Tool Node](#-comfyui-tool-node)
+- [ComfyUI Node](#-comfyui-node)
+- [Advanced Usage](#-advanced-usage)
+- [Troubleshooting](#-troubleshooting)
+- [Configuration Reference](#-configuration-reference)
+
+## 🎯 Overview
+
+This package provides two specialized nodes for integrating ComfyUI with n8n:
+
+### 🌟 Key Features
 
 - 🎨 **Universal Workflow Support** - Works with any ComfyUI workflow in API format
-- 🔄 **Dynamic Parameters** - Override workflow parameters dynamically
+- 🔄 **Dynamic Parameters** - Override workflow parameters at runtime
 - 🎬 **Multi-Modal Support** - Supports images and videos for both input and output
-- 🤖 **AI Agent Ready** - Can be used as a tool in AI Agent workflows
+- 🤖 **AI Agent Ready** - Optimized nodes for AI Agent and standard workflows
 - 📊 **Flexible Configuration** - JSON mode or single parameter mode
-- 🔗 **URL Image Support** - Load images from URLs or binary data
-- 🏷️ **Customizable Output** - Customize binary output property names
+- 🏷️ **Customizable Output** - Flexible output format (URLs or binary data)
+
+---
 
 ## 📦 Installation
 
@@ -32,286 +49,590 @@ npm install n8n-nodes-comfyui-all
 
 Or via n8n interface: **Settings** → **Community Nodes** → **Install** → `n8n-nodes-comfyui-all`
 
-> Restart n8n after installation.
+> ⚠️ **Restart n8n after installation**
+
+---
+
+## 🔍 Nodes Comparison
+
+### Quick Reference
+
+| Feature | ComfyUI Tool 🤖 | ComfyUI 🔧 |
+|---------|----------------|------------|
+| **Primary Use Case** | AI Agent Workflows | Standard Workflows |
+| **Image Input** | URL only | Binary or URL |
+| **Binary Output** | ❌ No | ✅ Yes |
+| **URL Output** | ✅ Yes | ✅ Yes |
+| **Parameter Overrides** | ✅ Yes | ✅ Yes (Advanced) |
+| **LLM Context** | ✅ Lightweight (URLs only) | ⚠️ Not optimized |
+| **Node Configuration** | Simple | Advanced |
+
+### Which Node Should I Use?
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Your Scenario                                           │
+└─────────────────────────────────────────────────────────────┘
+                            │
+            ┌───────────────┴───────────────┐
+            │                               │
+     Using AI Agent?              Standard Workflow?
+            │                               │
+            ▼                               ▼
+    ┌───────────────┐              ┌──────────────┐
+    │ ComfyUI Tool  │              │   ComfyUI    │
+    └───────────────┘              └──────────────┘
+            │                               │
+     Image Input: URL              Image Input:
+                                    • Binary
+                                    • URL
+```
+
+#### Use ComfyUI Tool When:
+- ✅ Building AI Agent workflows
+- ✅ Integrating with chat interfaces
+- ✅ Processing images from URLs
+- ✅ Minimizing LLM token usage
+- ✅ Need simple URL-based configuration
+
+#### Use ComfyUI Node When:
+- ✅ Building standard n8n workflows
+- ✅ Processing binary data from previous nodes
+- ✅ Working with file uploads/webhooks
+- ✅ Need advanced parameter configuration
+- ✅ Want binary output for further processing
+
+---
 
 ## 🚀 Quick Start
 
-### 1. Prerequisites
+### Prerequisites
+
+- ✅ ComfyUI server running (default: `http://127.0.0.1:8188`)
+- ✅ n8n instance (version 2.x or higher)
+- ✅ Basic understanding of ComfyUI workflows
 
-- ComfyUI server running (default: `http://127.0.0.1:8188`)
-- n8n instance (version 2.x or higher)
+### 3-Step Setup
 
-### 2. Create Your Workflow in ComfyUI
+#### 1. Create Your Workflow in ComfyUI
 
-1. Design your workflow in ComfyUI
-2. Click **Save (API Format)** to export
+```
+In ComfyUI:
+1. Design your workflow
+2. Click "Save (API Format)"
 3. Copy the generated JSON
+```
+
+#### 2. Add Node to n8n
+
+```
+In n8n:
+1. Add either "ComfyUI Tool" or "ComfyUI" node
+2. Paste your Workflow JSON
+3. Configure ComfyUI URL
+4. (Optional) Set up parameters
+```
 
-### 3. Configure n8n Node
+#### 3. Execute
 
-1. Add **ComfyUI** node to your n8n workflow
-2. Set **ComfyUI URL**: `http://127.0.0.1:8188`
-3. Paste your **Workflow JSON**
-4. Optionally configure **Node Parameters**
+```
+Run your workflow and enjoy! 🎉
+```
 
-## 📖 Usage
+---
 
-### Basic Example: Text to Image
+## 🤖 ComfyUI Tool Node
 
-**Node Configuration:**
-- **ComfyUI URL**: `http://127.0.0.1:8188`
-- **Workflow JSON**: Your ComfyUI workflow in API format
+### Overview
 
-**Optional Node Parameters (Single Parameter Mode):**
-- Node ID: `6` (your CLIP text node)
-- Parameter Name: `text`
-- Type: `Text`
-- Value: `a beautiful landscape, high quality`
+**Optimized for AI Agent workflows** - URL-based image input, simple configuration, LLM-friendly.
 
-### Parameter Configuration Modes
+### Why URL-Based Input?
 
-#### 1. Multiple Parameters Mode (JSON)
+```
+❌ Base64 Image:
+   - Size: ~100KB - 1MB per image
+   - Tokens: ~130K - 1.3M tokens
+   - Result: 💥 Explodes LLM context
+
+✅ Image URL:
+   - Size: ~100 bytes
+   - Tokens: ~30 tokens
+   - Result: ✅ Lightweight and efficient
+```
+
+### Configuration
 
-Configure multiple parameters at once using JSON:
+#### Basic Setup
+
+```
+┌─────────────────────────────────────────────────┐
+│ ComfyUI Tool                                    │
+├─────────────────────────────────────────────────┤
+│ ComfyUI URL:     http://127.0.0.1:8188         │
+│ Workflow JSON:   [Your ComfyUI workflow]        │
+│ Timeout:         300                            │
+│ Load Image Node ID:                             │
+│   (for image workflows)                         │
+│ Image URL:       [URL or {{ $json.imageUrl }}] │
+└─────────────────────────────────────────────────┘
+```
+
+#### Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| **ComfyUI URL** | ComfyUI server address | `http://127.0.0.1:8188` |
+| **Workflow JSON** | ComfyUI workflow in API format | `{ "3": {...} }` |
+| **Timeout** | Max wait time (seconds) | `300` (5 min) |
+| **Load Image Node ID** | LoadImage node ID for image workflows | `107` |
+| **Image URL** | URL of image to process | `https://...` |
+| **Parameter Overrides** | Override workflow parameters | See below |
+
+### Output Format
 
 ```json
 {
-  "width": 1024,
-  "height": 1024,
-  "batch_size": 1,
-  "seed": 12345
+  "success": true,
+  "imageUrls": [
+    "http://127.0.0.1:8188/view?filename=ComfyUI_00001.png"
+  ],
+  "videoUrls": [],
+  "imageCount": 1,
+  "videoCount": 0
 }
 ```
 
-#### 2. Single Parameter Mode
+### AI Agent Integration Example
+
+```
+Workflow:
+[Chat Input] → [AI Agent] → [ComfyUI Tool]
+                          ↓
+                    Passes imageUrl
+                          ↓
+                    Downloads image
+                          ↓
+                    Processes in ComfyUI
+                          ↓
+                    Returns result URLs
+```
+
+**Chat Example:**
 
-Configure one parameter at a time with type validation:
+```
+User: Transform this image (https://example.com/photo.png)
+       to oil painting style
 
-- **Parameter Name**: `steps`
-- **Type**: `Number`
-- **Value**: `25`
+AI Agent:
+1. Extracts URL from message
+2. Calls ComfyUI Tool
+3. ComfyUI Tool downloads image
+4. Processes in ComfyUI
+5. Returns result URLs
+6. AI Agent shows result to user
+```
 
-### Image Input Options
+---
 
-The node supports two methods for uploading images to ComfyUI:
+## 🔧 ComfyUI Node
 
-#### Method 1: Binary Data
+### Overview
 
-Upload images from n8n binary data:
+**Full-featured node for standard workflows** - Supports binary and URL inputs with advanced configuration.
 
-- **Type**: `Image`
-- **Image Input Type**: `Binary`
-- **Value**: Binary property name (e.g., `data`, `image`, `file`)
+### Configuration
 
-#### Method 2: URL
+#### Basic Setup
 
-Download and upload images from a URL:
+```
+┌─────────────────────────────────────────────────┐
+│ ComfyUI                                         │
+├─────────────────────────────────────────────────┤
+│ ComfyUI URL:     http://127.0.0.1:8188         │
+│ Workflow JSON:   [Your ComfyUI workflow]        │
+│ Timeout:         300                            │
+│ Output Binary Key: data                         │
+├─────────────────────────────────────────────────┤
+│ Node Parameters:                                │
+│   [Multiple parameter configurations]            │
+└─────────────────────────────────────────────────┘
+```
+
+#### Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| **ComfyUI URL** | ComfyUI server address | `http://127.0.0.1:8188` |
+| **Workflow JSON** | ComfyUI workflow in API format | `{ "3": {...} }` |
+| **Timeout** | Max wait time (seconds) | `300` (5 min) |
+| **Output Binary Key** | First output binary property name | `data`, `image` |
+| **Node Parameters** | Override workflow parameters | See below |
+
+### Image Input Methods
+
+#### Method 1: Binary Data
 
-- **Type**: `Image`
-- **Image Input Type**: `URL`
-- **Image URL**: Full URL of the image (e.g., `https://example.com/image.png`)
+```
+Node Parameters:
+  Node ID: 107
+  Parameter Mode: Single Parameter
+  Parameter Name: image
+  Type: Image
+  Image Input Type: Binary  ← Binary mode
+  Value: data
+```
 
-The node will automatically download the image from the URL and upload it to ComfyUI.
+**Use when:** Previous node outputs binary data (HTTP Request, Webhook, etc.)
 
-### Custom Output Binary Key
+#### Method 2: URL
 
-By default, the first output image/video uses `data` as the binary property name. You can customize this:
+```
+Node Parameters:
+  Node ID: 107
+  Parameter Mode: Single Parameter
+  Parameter Name: image
+  Type: Image
+  Image Input Type: URL  ← URL mode
+  Image URL: https://example.com/image.png
+```
+
+**Use when:** Downloading from web or using URL
 
-- **Output Binary Key**: Property name for the first output (e.g., `image`, `output`, `result`)
-- Default: `data`
+### Output Format
 
-**Example:**
 ```json
 {
+  "json": {
+    "success": true,
+    "imageCount": 1,
+    "imageUrls": ["http://..."],
+    "data": { ... }
+  },
   "binary": {
-    "myImage": { "data": "...", "mimeType": "image/png" }
+    "data": {
+      "data": "base64...",
+      "mimeType": "image/png",
+      "fileName": "ComfyUI_00001.png"
+    }
   }
 }
 ```
 
-## 🤖 AI Agent Integration
+---
 
-Use ComfyUI as a tool in AI Agent workflows.
+## 📚 Advanced Usage
 
-### Quick Setup
+### 1. Text-to-Image with Dynamic Prompts
 
-**Step 1: Create AI Agent**
-1. Add **OpenAI Conversational Agent** node
-2. Configure Chat Model (GPT-4/GPT-3.5)
-3. Add Memory (optional but recommended)
+**ComfyUI Node Setup:**
 
-**Step 2: Add ComfyUI Tool**
-1. Click AI Agent node
-2. In **Tools** section, click **+ Add Tool**
-3. Search and select **ComfyUI**
-4. Configure:
-   - **ComfyUI URL**: `http://127.0.0.1:8188`
-   - **Workflow JSON**: Your ComfyUI workflow (API format)
-   - **Node Parameters**: Configure text parameter override
+```
+Node Parameters:
+  Node ID: 6 (CLIP Text Encode)
+  Parameter Mode: Single Parameter
+  Parameter Name: text
+  Type: Text
+  Value: {{ $json.prompt }}
+```
 
-**Step 3: Start Chatting**
-Execute workflow and start conversing!
+**Input:**
+```json
+{
+  "prompt": "a beautiful landscape at sunset"
+}
+```
 
-### Example Conversations
+### 2. Image-to-Image Processing
 
-**Basic Image Generation:**
+**ComfyUI Tool Setup:**
 
-**User:**
 ```
-Generate a picture of a cute cat sitting on a fence
+Load Image Node ID: 107
+Image URL: {{ $json.imageUrl }}
+Parameter Overrides:
+  - Node ID: 6
+    Param Path: inputs.text
+    Value: {{ $json.prompt }}
 ```
 
-**AI:**
-```
-I'll generate that for you.
-[Executes ComfyUI with prompt: "a cute cat sitting on a fence"]
-Done! Here's the image.
+**Input:**
+```json
+{
+  "imageUrl": "https://example.com/input.png",
+  "prompt": "Transform to oil painting style"
+}
 ```
 
-**With Parameters:**
+### 3. Multiple Parameters Override
+
+**ComfyUI Node Setup:**
 
-**User:**
 ```
-Create a cyberpunk city, size:1024x768, steps:30
+Node Parameters:
+  Node ID: 3
+  Parameter Mode: Multiple Parameters
+  Parameters JSON:
+    {
+      "width": 1024,
+      "height": 1024,
+      "steps": 30,
+      "cfg": 7.5,
+      "seed": 123456
+    }
 ```
 
-**Supported Parameters:**
-- `size:WIDTHxHEIGHT` - Image dimensions
-- `steps:N` - Sampling steps
-- `cfg:N` - CFG strength
-- `seed:N` - Random seed
-- `negative:TEXT` - Negative prompt
+### 4. Video Generation
 
-**Negative Prompts:**
+**Setup:** Similar to image generation, just use a video workflow in ComfyUI.
 
-**User:**
-```
-Draw a beautiful sunset, negative: blurry, low quality
+**Output:**
+```json
+{
+  "videoUrls": ["http://127.0.0.1:8188/view?filename=video.mp4"],
+  "videoCount": 1
+}
 ```
 
-### Configuring Node Parameters for AI Agent
+---
 
-In the ComfyUI node, configure parameter overrides:
+## 🤖 AI Agent Workflows
 
-- **Node ID**: `6` (your CLIP text node)
-- **Parameter Mode**: Single Parameter
-- **Parameter Name**: `text`
-- **Type**: Text
-- **Value**: [Leave empty - AI Agent will fill this]
+### Example 1: Image Generation Chat
 
-### Tool Mode Output Format
+```
+Workflow:
+[Chat Interface] → [AI Agent] → [ComfyUI Tool]
+
+Configuration:
+  - Model: GPT-4
+  - Tools: ComfyUI Tool
+  - Workflow: Text-to-Image
+
+Conversation:
+  User: "Generate a picture of a cute cat"
+  AI: [Calls ComfyUI Tool]
+  AI: "Here's your image! 😊"
+```
 
-When used as an AI Agent tool, ComfyUI returns both binary data and URL information:
+### Example 2: Image Editing
 
-**Binary Output:**
-- Images are returned as binary data (base64-encoded) in the `binary` object
-- First image: `binary.data`
-- Additional images: `binary.image_1`, `binary.image_2`, etc.
-- Videos: `binary.video_0`, `binary.video_1`, etc.
+```
+Workflow:
+[Chat Interface] → [AI Agent] → [ComfyUI Tool]
+
+Configuration:
+  - ComfyUI Tool:
+    - Workflow: Image-to-Image
+    - Load Image Node ID: 107
+    - Image URL: {{ $json.imageUrl }}
+
+Conversation:
+  User: "Transform this image (URL) to watercolor style"
+  AI: [Extracts URL, downloads image, processes in ComfyUI]
+  AI: "Done! Here's the watercolor version 🎨"
+```
 
-**JSON Output (with URLs):**
-- `json.images`: Array of image paths
-- `json.imageUrls`: Array of complete image URLs (e.g., `http://127.0.0.1:8188/view?filename=...`)
-- `json.videos`: Array of video paths
-- `json.videoUrls`: Array of complete video URLs
-- `json.imageCount`: Number of images generated
-- `json.videoCount`: Number of videos generated
+### Example 3: Multi-Modal Workflow
 
-This ensures compatibility with both workflow mode (binary data) and tool mode (URLs for AI Agent).
+```
+Workflow:
+[Chat Input] → [AI Agent] → [ComfyUI Tool] → [Chat Model]
+                          ↓                           ↓
+                      Generate Image               Write Poem
+                          ↓                           ↓
+                      Return Combined Result
+
+Conversation:
+  User: "Create an image of a futuristic city
+        and write a poem about it"
+
+  AI: [1. Generates image via ComfyUI Tool]
+      [2. Writes poem about the image]
+      [3. Returns both to user]
+```
 
-### Best Practices
+---
 
-**1. Clear Prompts**
+## ⚙️ Best Practices
 
-**Good:** "Generate a landscape painting of mountains at sunset"
+### 1. URL Selection
 
-**Bad:** "Make a picture"
+✅ **Good:**
+```
+https://cdn.example.com/images/photo.png
+https://storage.googleapis.com/bucket/image.jpg
+https://s3.amazonaws.com/bucket/photo.png
+```
 
-**2. Use Specific Parameters**
+❌ **Avoid:**
+```
+file:///local/path/image.png  ← Not accessible
+http://localhost:8080/image.png  ← Private network
+```
 
-**Good:** "Create a portrait, size:512x768, steps:25"
+### 2. Parameter Naming
 
-**Bad:** "Create a high-quality portrait"
+✅ **Use Clear Names:**
+```
+Node ID: 6
+Parameter Name: text  ← Matches ComfyUI node input
+```
 
-**3. Negative Prompts**
+❌ **Vague Names:**
+```
+Node ID: node_6
+Parameter Name: param1  ← Unclear what it does
+```
 
-Always use negative prompts for better quality:
+### 3. Timeout Settings
 
 ```
-A beautiful landscape, negative: blurry, distorted, low quality
+Simple workflows:      60-120 seconds
+Complex workflows:     300-600 seconds
+Video generation:      600-1800 seconds
 ```
 
-### Advanced Usage
+### 4. Error Handling
 
-**Style Transfer:**
+```javascript
+// Always validate inputs
+if (!workflowJson) {
+  throw new Error('Workflow JSON is required');
+}
 
-**User:**
-```
-Transform this image to oil painting style
+// Check ComfyUI server availability
+// Use appropriate timeouts
+// Handle network errors gracefully
 ```
 
-Setup:
-- Upload input image as binary data
-- Configure style parameters
+---
 
-**Multi-Modal Workflows:**
+## 🔧 Troubleshooting
 
-Combine ComfyUI with other tools:
+### Common Issues
 
-**User:**
-```
-Generate an image of a futuristic city, then write a poem about it
-```
+#### ❌ "Invalid ComfyUI URL"
 
-AI Agent:
-1. Calls ComfyUI to generate image
-2. Calls Chat Model to write poem
-3. Returns both results
+**Solution:**
+- Check ComfyUI is running
+- Verify URL format: `http://127.0.0.1:8188`
+- Try accessing ComfyUI in browser first
+
+#### ❌ "Workflow execution timeout"
+
+**Solutions:**
+- Increase timeout value
+- Check workflow complexity
+- Verify ComfyUI server performance
+- Check ComfyUI logs for errors
+
+#### ❌ "Node ID not found in workflow"
 
-### Troubleshooting
+**Solutions:**
+- Open workflow JSON
+- Find the correct node ID
+- Note: IDs are strings like "6", "13", not numbers
 
-**AI Agent Doesn't Call ComfyUI**
+#### ❌ "Failed to download image from URL"
 
-**Check:**
-1. ComfyUI tool added to Tools list?
-2. Workflow JSON configured?
-3. ComfyUI server running?
+**Solutions:**
+- Verify URL is publicly accessible
+- Check URL doesn't require authentication
+- Ensure URL returns image (not HTML)
+- Test URL in browser first
 
-**Images Don't Match Prompts**
+#### ❌ "AI Agent doesn't call ComfyUI"
 
-**Check:**
-1. Correct node ID (e.g., `6` for CLIP text)
-2. Parameter name matches workflow (`text`)
-3. Workflow uses dynamic text input
+**Solutions:**
+- Ensure ComfyUI Tool is added to Agent's tools
+- Check tool description is clear
+- Verify workflow JSON is configured
+- Check Agent logs
 
-## 🔧 Configuration Reference
+---
 
-| Field | Description |
-|-------|-------------|
-| **ComfyUI URL** | URL of your ComfyUI server |
-| **Workflow JSON** | ComfyUI workflow in API format |
-| **Timeout** | Maximum wait time in seconds (default: 300) |
-| **Output Binary Key** | Property name for first output binary data (default: `data`) |
-| **Node Parameters** | Override workflow parameters |
+## 📖 Configuration Reference
 
-#### Node Parameter Fields
+### ComfyUI Tool Node
 
-| Field | Description |
-|-------|-------------|
-| **Node ID** | The node ID in your workflow (e.g., `6`, `13`) |
-| **Parameter Mode** | Single Parameter or Multiple Parameters (JSON) |
-| **Type** | Data type: Text, Number, Boolean, or Image |
-| **Image Input Type** | (When Type=Image) Binary or URL |
-| **Image URL** | (When Image Input Type=URL) URL to download image from |
-| **Parameter Name** | (Single mode) Parameter name to override |
-| **Parameters JSON** | (Multiple mode) JSON object with parameters |
-| **Value** | Value to set (varies by Type) |
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| **ComfyUI URL** | String | ✅ | `http://127.0.0.1:8188` | ComfyUI server address |
+| **Workflow JSON** | String | ✅ | - | ComfyUI workflow in API format |
+| **Timeout** | Number | ❌ | `300` | Max wait time (seconds) |
+| **Load Image Node ID** | String | ❌ | - | LoadImage node ID for image workflows |
+| **Image URL** | String | ❌ | - | URL of image to process |
+| **Parameter Overrides** | Collection | ❌ | - | Override workflow parameters |
+
+### ComfyUI Node
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| **ComfyUI URL** | String | ✅ | `http://127.0.0.1:8188` | ComfyUI server address |
+| **Workflow JSON** | String | ✅ | - | ComfyUI workflow in API format |
+| **Timeout** | Number | ❌ | `300` | Max wait time (seconds) |
+| **Output Binary Key** | String | ❌ | `data` | First output binary property name |
+| **Node Parameters** | Collection | ❌ | - | Override workflow parameters |
+
+### Node Parameter Fields
+
+| Field | Description | Options |
+|-------|-------------|---------|
+| **Node ID** | Node ID from workflow JSON | e.g., `6`, `13`, `107` |
+| **Parameter Mode** | How to configure parameters | Single / Multiple |
+| **Type** | Parameter data type | Text / Number / Boolean / Image |
+| **Image Input Type** | How to input image (when Type=Image) | Binary / URL |
+| **Parameter Name** | Parameter to override (single mode) | e.g., `text`, `seed`, `steps` |
+| **Parameters JSON** | JSON object with parameters (multiple mode) | `{"width": 1024}` |
+| **Value** | Value to set | Text / Number / Boolean |
+
+---
 
 ## 💡 Tips
 
-- **First time**: Start with a simple text-to-image workflow
-- **Parameter overrides**: Use Node Parameters instead of modifying workflow JSON
-- **Seed control**: Fixed seeds produce reproducible results
-- **Optimization**: 20-30 sampling steps are usually sufficient
-- **Image input**: Use Image type with Binary source for n8n binary data, or URL source to download from web
-- **Output naming**: Customize Output Binary Key to match your workflow's expected property names
+### 🎯 Performance
+
+- Start with simple workflows to test setup
+- Use appropriate timeout values
+- Monitor ComfyUI resource usage
+- Use specific prompts for better results
+
+### 🔒 Security
+
+- Don't expose ComfyUI server publicly
+- Use secure URLs for images
+- Validate user inputs in production
+- Keep workflow JSON private if needed
+
+### 📝 Workflow Design
+
+- Document your ComfyUI workflows
+- Use consistent node IDs
+- Test workflows in ComfyUI first
+- Keep workflows simple and modular
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit issues or pull requests.
+
+## 📄 License
+
+MIT License - see LICENSE file for details
+
+## 🙏 Acknowledgments
+
+- [ComfyUI](https://github.com/comfyanonymous/ComfyUI) - Powerful UI for Stable Diffusion
+- [n8n](https://n8n.io) - Workflow automation tool
+
+---
+
+**Need Help?**
+
+- 📖 Check the [Documentation](https://docs.n8n.io)
+- 💬 Join the [Community](https://community.n8n.io)
+- 🐛 Report [Issues](https://github.com/your-repo/issues)
+
+**Happy Automating! 🚀**