adding node configruation help

This commit is contained in:
John Doe
2025-11-27 14:38:08 -05:00
parent 4e6a8504e5
commit d7b7fecdcd

103
OPEN_WEBUI_COMFYUI_SETUP.md Normal file
View File

@@ -0,0 +1,103 @@
# Open WebUI ComfyUI Integration Setup Guide
This guide will help you configure Open WebUI to work with ComfyUI for AI image generation.
## Prerequisites
- Open WebUI running and accessible
- ComfyUI running on your local network (typically at `http://172.28.0.5:8188`)
- Admin access to Open WebUI
## Configuration Steps
### 1. Navigate to Admin Settings
1. Open your Open WebUI interface in a web browser
2. Click on the **Admin** section in the navigation menu
3. Go to **Settings**
4. Select **Images** from the settings menu
### 2. Configure Image Generation Engine
In the Images settings page, configure the following:
#### Image Generation Engine
- Select: **ComfyUI**
#### ComfyUI Base URL
```
http://172.28.0.5:8188
```
### 3. ComfyUI Workflow Configuration
#### Workflow Setup
1. In ComfyUI, create your desired workflow
2. **Export the workflow as API format**:
- In ComfyUI interface, go to the workflow menu
- Choose "Export"
- Select "API Format"
- Save as `workflow.json`
3. **Upload the workflow**:
- In Open WebUI Images settings, click "Upload" under ComfyUI Workflow
- Select your exported `workflow.json` file
#### Required Workflow Nodes
Configure the following node mappings in the ComfyUI Workflow Nodes section:
| Parameter | Node Type | Node ID | Description |
|-----------|-----------|---------|-------------|
| **prompt*** | text | 6 | Text prompt input (required) |
| **model** | unet_name | 37 | Model selection |
| **width** | width | 58 | Image width |
| **height** | height | 58 | Image height |
| **steps** | steps | 3 | Sampling steps |
| **seed** | seed | 3 | Random seed |
> **Note**: Prompt node ID(s) marked with * are required for image generation to work.
## Important Notes
1. **Network Configuration**: Ensure that Open WebUI can reach ComfyUI at the specified IP address (`172.28.0.5:8188`)
2. **API Format Export**: Always export your ComfyUI workflow in API format, not the regular format
3. **Node IDs**: The node IDs (like 6, 37, 58, 3) must match the actual node IDs in your ComfyUI workflow
4. **Required Nodes**: The prompt node is mandatory - image generation will fail without it
## Troubleshooting
### Common Issues
1. **Connection Failed**:
- Verify ComfyUI is running on `172.28.0.5:8188`
- Check network connectivity between Open WebUI and ComfyUI
2. **Workflow Errors**:
- Ensure workflow was exported in API format
- Verify all required nodes are present in the workflow
- Check that node IDs match your actual workflow
3. **Missing Images**:
- Confirm the prompt node ID is correctly configured
- Ensure ComfyUI has the required models installed
### Verification Steps
1. Test the ComfyUI connection by visiting `http://172.28.0.5:8188` in your browser
2. Generate a test image through Open WebUI to verify the integration
3. Check ComfyUI logs for any error messages if generation fails
## Additional Configuration
- **Edit Image**: Additional image editing capabilities can be configured through the same interface
- **Custom Workflows**: You can upload different workflows for various image generation tasks
- **Model Management**: Ensure required models are available in your ComfyUI installation
---
*For more advanced configuration options, refer to the Open WebUI and ComfyUI documentation.*