Skip to main content
ComfyStream is available as a custom node through the ComfyUI Manager or as a Docker image. Follow the method that best suits your setup.
You can also install Comfystream by cloning the repository into your ComfyUI/custom_nodes folder — see Manual Installation for details.

ComfyUI Manager (Recommended)

Install ComfyStream directly into an existing ComfyUI setup.

Docker (Self-contained)

Run ComfyStream and ComfyUI together in a prebuilt Docker container.

​
Install with ComfyUI Manager

If you already have ComfyUI installed, the easiest way to install ComfyStream is via the built-in ComfyUI Manager.
1

Install ComfyUI (if needed)

Download and install ComfyUI if you haven’t already.
Currently comfystream works only with the hiddenswitch fork of ComfyUI, the team is actively working add full support for official ComfyUI.
ComfyUI must be run with frontend version v1.24.2 or older. You can do this by launching ComfyUI with the flag --front-end-version Comfy-Org/ComfyUI_frontend@v1.24.2
2

Install ComfyUI Manager (if needed)

Follow the ComfyUI Manager installation guide if you haven’t already.
3

Install ComfyStream via Manager

  1. Launch ComfyUI.
  2. Open the Manager tab.
  3. Search for ComfyStream and click Install.
4

Restart ComfyUI

Restart your ComfyUI server to load the new custom node.

​
Manual Installation

If you prefer more control over the installation process, you can install ComfyStream manually using one of the following methods:
Python 3.12 or greater is required
The following commands install the latest version of ComfyUI and ComfyStream
pip install comfy-cli
comfy install
comfy node registry-install comfystream
After completing the installation, start ComfyUI with the following command
comfy launch -- --listen 0.0.0.0 --port 8188 --front-end-version Comfy-Org/ComfyUI_frontend@v1.24.2
This will start the ComfyUI server with ComfyStream installed.
If you prefer to install ComfyStream manually by cloning the repository instead of using the Manager, follow these steps:
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
pip -r requirements.txt
cd custom_nodes
git clone https://github.com/livepeer/comfystream.git
cd comfystream
python install.py
After completing the installation, navigate to the root of the ComfyUI directory.
cd ComfyUI
python main.py --listen --front-end-version Comfy-Org/ComfyUI_frontend@v1.24.2
This will start the ComfyUI server with ComfyStream installed.

​
Install with Docker

Run ComfyStream in a prebuilt Docker environment, either on your own GPU or a cloud server.

Local GPU

Run ComfyStream locally with your own GPU.

Remote GPU

Deploy ComfyStream on a remote GPU using RunPod or Ansible.

​
Local GPU

If you have a compatible GPU on Windows or Linux, you can run ComfyStream locally via Docker.

​
Prerequisites

First, install the required system software:
1

Install WSL 2

  • From a new command prompt, run: wsl --install - Update WSL if needed: wsl.exe --update
2

Launch Ubuntu in Terminal

Open a new Ubuntu (WSL) tab from Terminal.
3

Install NVIDIA CUDA Toolkit

Inside of WSL, install NVIDIA CUDA Toolkit
4

Install Docker Desktop

Install Docker Desktop.
5

Enable WSL 2 Engine in Docker

Ensure Docker Desktop is set to use the WSL 2 Engine in settings.
6

Verify Docker Access

Inside WSL: docker ps should return a result.
7

Continue with setup

Proceed with the next steps in your WSL terminal.

​
Run the Docker Container

1

Create model and output directories

These folders store your models and generated outputs. Docker mounts them into the container.
mkdir -p ~/models/ComfyUI--models ~/models/ComfyUI--output
2

Pull the ComfyStream container

docker pull livepeer/comfystream:stable
If using Windows, ensure Docker Desktop is running first.
3

Run the container

docker run -it --gpus all \
  -p 8188:8188 \
  -p 8889:8889 \
  -p 5678:5678 \
  -p 3000:3000 \
  -v ~/models/ComfyUI--models:/workspace/ComfyUI/models \
  -v ~/models/ComfyUI--output:/workspace/ComfyUI/output \
  livepeer/comfystream:stable --download-models --build-engines --server
Available flags:
  • --download-models downloads some default models
  • --build-engines optimizes the runtime for your GPU
  • --server starts ComfyUI server (accessible on port 8188)
  • --api enables the API server
  • --ui starts the ComfyStream UI (accessible on port 3000)
  • --use-volume should be used with a mount point at /app/storage. It is used during startup to save/load models and compiled engines to a host volume mount for persistence
The --download-models and --build-engines flags are only needed the first time (or when adding new models).
4

Access ComfyUI

Open your browser and go to http://localhost:8188 to start using ComfyUI with ComfyStream.
5

Access ComfyStream UI

The ComfyStream UI is available at http://localhost:3000 where you can start live streams directly by keeping the stream URL as http://localhost:8889 and selecting a workflow.ComfyStream UI

​
Remote GPU

If you don’t have a local GPU, you can run ComfyStream on a cloud server. Choose between a managed deployment with RunPod or manual setup using Ansible.

​
Run with RunPod

RunPod provides a simple one-click deployment of ComfyStream in a managed container environment — perfect for testing or avoiding manual setup.
1

Launch the RunPod template

Use this template to get started: livepeer-comfystream
RunPod does not persist pod data by default. To ensure models and engines persist across pod restarts, use the RunPod template livepeer-comfystream-volumeThis template uses the --use-volume flag to save all models and engines to the mount path /app/storage. A network volume is required.
2

Create a network volume

When using the persistent template, create and attach a network volume.New Network Volume
3

Choose your GPU and deploy

Select a suitable GPU (e.g. RTX 4090), then click Deploy On-Demand.
4

Monitor deployment

Use the Logs button to watch the container spin up.runpod-log
5

Access ComfyUI

Once running, click Connect from the pod dashboard.comfyui-connect-pod
6

Open ComfyUI

Click the HTTP Service → :8188 link. It will open in a new browser tab.
7

Access ComfyStream UI

To access the ComfyStream UI, use the TCP ports to form a URL beginning with https:// followed by the IP:port for port 3000.You can start a live stream directly from the ComfyStream UI by keeping the stream URL as http://localhost:8889 and selecting a workflow.ComfyStream UI

​
Deploy with Ansible

Use Ansible to deploy ComfyStream to your own cloud VM (like AWS, GCP, Azure, or TensorDock). Great if you want more control or a repeatable, fully automated setup.
1

Create a cloud VM

Provision a VM with at least:
  • GPU: 20GB VRAM
  • RAM: 16GB
  • CPU: 4 vCPUs
  • Disk: 100GB
2

Open required ports

Allow incoming traffic on:
  • 22 (SSH – internal port)
  • 8189 (ComfyStream HTTPS – internal port)
Ensure your cloud provider maps these to public ports. Internal port 8189 is proxied to 8188, which serves the ComfyUI interface.
3

Install Ansible

Install Ansible on your local machine (not the VM). See the official installation guide.
4

Clone the ComfyStream playbook

git clone https://github.com/livepeer/comfystream.git
cd comfystream/scripts/ansible
No need to install anything on the VM — Ansible sets it all up over SSH.
5

Add your VM IP to the inventory

Open inventory.yml and add your VM’s public IP address.
6

Set a custom password (optional)

Edit the comfyui_password value in plays/setup_comfystream.yaml.
This sets the password used to access ComfyUI in your browser.
7

Run the playbook

ansible-playbook -i inventory.yaml plays/setup_comfystream.yaml
If you’re not using a root user, add --ask-become-pass to enter your sudo password.
The playbook pulls a ~20GB Docker image on the VM. This may take a while on first run.
8

Monitor download progress (optional)

If needed, SSH into the VM and run:
docker pull livepeer/comfystream:stable
Helpful if you’re unsure whether the download is progressing during first-time setup.
9

Open ComfyUI

Visit https://<VM_IP>:<PUBLIC_COMFYUI_PORT> in your browser.

​
Accessing ComfyStream

  1. Click the ComfyStream menu button in ComfyUI:
    ComfyStream Menu Button
  2. Open Server Settings to verify that ComfyStream is configured to bind to the correct interface and port.
    For remote environments like RunPod, set the Host to 0.0.0.0.
    Server Settings
  3. Click Save to apply the settings.
  4. Open the ComfyStream menu again and click Start ComfyStream Server. Wait for the server status indicator to turn green.
    You can monitor ComfyStream server logs in the ComfyUI log terminal tab.
  5. Click Open ComfyStream UI to launch it in a new tab. Alternatively, double-click the node graph and search for ComfyStream UI Preview.
    ComfyStream UI Preview

​
Troubleshooting

If you encounter a toomanyrequests error while pulling the Docker image, either wait a few minutes or provide your Docker credentials when running the playbook:
ansible-playbook -i inventory.yaml plays/setup_comfystream.yaml -e "docker_hub_username=your_dockerhub_username docker_hub_password=your_dockerhub_pat"