Install ComfyStream
A quick start guide to running your first AI video workflow with ComfyStream
ComfyStream is available as a docker image at livepeer/comfystream:latest. An NVIDIA GPU is required to run ComfyStream.
Choose a platform to install ComfyStream:
Local GPU
Run ComfyStream and ComfyUI on Linux or Windows with a local GPU
Remote GPU
Run ComfyStream and ComfyUI on RunPod with a rented GPU
Local GPU
Prerequisites
First, install the required system software:
Windows
Windows
- Install WSL 2:
- From a new command prompt, run:
wsl --install
- Update WSL if needed:
wsl.exe --update
- Launch a new Terminal, then open a tab for Ubuntu (WSL).
- Inside of WSL, install NVIDIA CUDA Toolkit for WSL.
- Install Docker Desktop for Windows for Windows.
- Ensure WSL 2 Engine is enabled in Docker Desktop settings.
- Inside of WSL, run
docker ps
to verify you have access to docker. - From the WSL Terminal, continue with the steps below to setup the local environment
Setting Up Local Environment
- Create directories for models and output:
- Pull and run the container:
If using Windows, ensure Docker Desktop is running first
The --download-models
and --build-engines
flags will download required models and build TensorRT engines. This process may take some time depending on your network connection and GPU hardware and is only needed on the first run or when adding new models.
Remote GPU
Deploy on RunPod
- Deploy using the RunPod template livepeer-comfystream
First-time deployment to a network volume takes approximately 20-45 minutes depending on pod performance. For faster deployment without data persistence, use the RunPod template livepeer-comfystream-novolume
- When using the livepeer-comfystream template, create and select a network volume to persist files.
- Select an appropriate GPU (ex: RTX 4090) and click Deploy On-Demand
- Click the Logs button to monitor deployment progress.
- Once the container is fully running, you can access ComfyUI by clicking Connect
Accessing ComfyUI
RunPod
RunPod
- Click Connect in pod dashboard
- Access ComfyUI: HTTP Service -> :8188
- ComfyUI will open in a new tab
Local
Local
When running the docker image locally, you can access ComfyUI at http://localhost:8188.
Accessing ComfyStream
-
From ComfyUI, click the ComfyStream menu button:
-
Click Server Settings to verify ComfyStream is configured to bind to the correct interface and port
When deploying to remote environments like RunPod, you will need to set the Host to0.0.0.0
. -
Click Save.
-
Open the ComfyStream menu again, then click Start ComfyStream Server. Wait for the server status indicator to turn green.
You can also monitor ComfyStream server logs in ComfyUI’s log terminal tab.
- Click Open ComfyStream UI to launch in a new tab. Alternatively, you can double-click the node graph and search for ComfyStream UI Preview