mirror of
https://github.com/open-webui/docs.git
synced 2025-12-12 07:29:49 +07:00
Merge pull request #825 from open-webui/main
This commit is contained in:
@@ -13,6 +13,8 @@ To run ComfyUI and make it accessible to Open WebUI, you must start it with the
|
||||
|
||||
Once running, the ComfyUI interface will be available at `http://<your_comfyui_ip>:8188`.
|
||||
|
||||

|
||||
|
||||
## Connecting ComfyUI to Open WebUI
|
||||
|
||||
Since Open WebUI typically runs inside Docker, you must ensure the container can reach the host-based ComfyUI application via `host.docker.internal`.
|
||||
@@ -54,8 +56,13 @@ Once you have ComfyUI installed and running, you can connect it to Open WebUI fr
|
||||

|
||||
|
||||
3. **Upload Your ComfyUI Workflow:**
|
||||
- First, you need to export a workflow from ComfyUI in the correct format. In the ComfyUI interface, click the ComfyUI logo at the top left and click **Settings**. Then toggle **"Dev Mode"** with a description that states "Enable dev mode options (API save, etc.)"**.
|
||||
- While still in ComfyUI, load the **image generation** workflow you want to use, and then click the **"Save (API Format)"** button. This will prompt you to give a name to the file. Name it something memorable and download the file.
|
||||
- First, you need to export a workflow from ComfyUI in the correct format. In the ComfyUI interface, click the ComfyUI logo at the top left and click **Settings**. Then search for and toggle on the **"Dev Mode"** option with a description that states **"Enable dev mode options (API save, etc.)"**.
|
||||
|
||||

|
||||
|
||||
- While still in ComfyUI, load the **image generation** workflow you want to use, and then click the **"Export (API)"** button found in the **File** sub-menu after clicking on the ComfyUI logo. This will prompt you to name the file. Name it something memorable and download it.
|
||||
|
||||

|
||||
- Back in Open WebUI, under the **ComfyUI Workflow** section, click **Upload**. Select the JSON workflow file you just downloaded.
|
||||
|
||||

|
||||
@@ -77,6 +84,8 @@ Once you have ComfyUI installed and running, you can connect it to Open WebUI fr
|
||||
5. **Save Configuration:**
|
||||
- Click the **Save** button at the bottom of the page to finalize the configuration. You can now use ComfyUI for image generation in Open WebUI.
|
||||
|
||||

|
||||
|
||||
## Edit Image
|
||||
|
||||
Open WebUI also supports image editing through ComfyUI, allowing you to modify existing images.
|
||||
@@ -93,6 +102,8 @@ Open WebUI also supports image editing through ComfyUI, allowing you to modify e
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
|
||||
### Deeper Dive: Mapping ComfyUI Nodes to Open WebUI
|
||||
|
||||
@@ -102,6 +113,8 @@ Understanding the node ID mapping is often the biggest hurdle in integrating Com
|
||||
|
||||
Before configuring Open WebUI, you must examine your exported workflow JSON files directly in a text editor. The Node ID is the unique number ComfyUI uses to identify the node in the JSON structure. The top-level keys in the JSON object are the node IDs.
|
||||
|
||||

|
||||
|
||||
**Identify the Input Key (The Parameter Name)**
|
||||
|
||||
The Input Key is the exact parameter name within that node's JSON structure that you need to change (e.g., `seed`, `width`, `unet_name`).
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
sidebar_position: 5
|
||||
sidebar_position: 6
|
||||
title: "Getting Started with Functions"
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
|
||||
sidebar_position: 4
|
||||
sidebar_position: 5
|
||||
title: "Starting with OpenAI-Compatible Servers"
|
||||
|
||||
---
|
||||
|
||||
38
docs/getting-started/quick-start/starting-with-vllm.mdx
Normal file
38
docs/getting-started/quick-start/starting-with-vllm.mdx
Normal file
@@ -0,0 +1,38 @@
|
||||
---
|
||||
sidebar_position: 4
|
||||
title: "Starting With vLLM"
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
vLLM provides an OpenAI-compatible API, making it easy to connect to Open WebUI. This guide will show you how to connect your vLLM server.
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Set Up Your vLLM Server
|
||||
|
||||
Make sure your vLLM server is running and accessible. The default API base URL is typically:
|
||||
|
||||
```
|
||||
http://localhost:8000/v1
|
||||
```
|
||||
|
||||
For remote servers, use the appropriate hostname or IP address.
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Add the API Connection in Open WebUI
|
||||
|
||||
1. Go to ⚙️ **Admin Settings**.
|
||||
2. Navigate to **Connections > OpenAI > Manage** (look for the wrench icon).
|
||||
3. Click ➕ **Add New Connection**.
|
||||
4. Fill in the following:
|
||||
- **API URL**: `http://localhost:8000/v1` (or your vLLM server URL)
|
||||
- **API Key**: Leave empty (vLLM typically doesn't require an API key for local connections)
|
||||
5. Click **Save**.
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Start Using Models
|
||||
|
||||
Select any model that's available on your vLLM server from the Model Selector and start chatting.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 2.8 MiB |
BIN
static/images/image-generation-and-editing/comfyui-dev-mode.png
Normal file
BIN
static/images/image-generation-and-editing/comfyui-dev-mode.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 109 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.9 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 200 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Reference in New Issue
Block a user