ComfyUI-Manager Installation

Desktop users

Comfy Desktop installs ComfyUI-Manager with every ComfyUI installation and starts it with --enable-manager, so there is nothing for you to install. Manager is configured per installation from inside the app:

Open the Manage panel for the installation

In Comfy Desktop, open the installation and go to the Manage panel, then switch to the Startup Args tab.

Set the Manager options

Manager Security Level decides which node packs Manager may install: Strict, Standard (recommended), Relaxed, or Permissive. Stricter levels matter most when ComfyUI is exposed to your network with --listen
Manager Network Mode decides how Manager reaches the node registry: Public (default), Private, Offline, or Personal cloud (only for a machine you control)

Both options apply the next time you launch the installation.

Change the flags Manager starts with (optional)

Startup Arguments on the same tab controls the flags the installation launches with. Remove --enable-manager to run ComfyUI without Manager, or keep it and add --disable-manager-ui to hide the Manager UI while its background tasks continue.

See the Startup Args tab for the rest of the per-installation settings and the startup flags reference for the Manager flags.

Portable users

For users running the Windows Portable version, the new ComfyUI-Manager is built into ComfyUI core but needs to be enabled.

Install the manager dependencies:

.\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt

Launch ComfyUI with the manager enabled:

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager
pause

Manual install users

For users with a manual installation, the new ComfyUI-Manager is built into ComfyUI core but needs to be enabled.

Activate your virtual environment:

# Windows
venv\Scripts\activate

# Linux/macOS
source venv/bin/activate

Install the manager dependencies:

pip install -r manager_requirements.txt

Enable the manager with the --enable-manager flag when running ComfyUI:
python main.py --enable-manager

Command line options

Flag	Description
`--enable-manager`	Enable ComfyUI-Manager
`--enable-manager-legacy-ui`	Use the legacy manager UI instead of the new UI (requires `--enable-manager`)
`--disable-manager-ui`	Disable the manager UI and endpoints while keeping background features (requires `--enable-manager`)

Switch between new and legacy UI

The following version updates only support pip installations. Versions installed via custom nodes do not support switching to the new UI.

Non-Desktop users
Desktop users

To use the new UI:

python main.py --enable-manager

To use the legacy UI:

python main.py --enable-manager --enable-manager-legacy-ui

Updating ComfyUI-Manager

ComfyUI-Manager ships as its own Python package, and ComfyUI core pins the version it works with in manager_requirements.txt. How you update the Manager depends on how ComfyUI is installed:

Desktop
Portable and manual installs
Git clone

Desktop includes the Manager and keeps it current with Comfy Desktop updates. Update the ComfyUI engine from the Manage panel.

Updating ComfyUI may leave the installed Manager package unchanged. Install the manager requirements in the environment you launch ComfyUI from, then restart ComfyUI with --enable-manager:

# Portable (Windows)
.\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager

# Manual install
pip install -r manager_requirements.txt
python main.py --enable-manager

If you cloned the Manager into custom_nodes yourself:

cd ComfyUI/custom_nodes/comfyui-manager
git pull

Then restart ComfyUI.

Legacy installation methods

Method 1: Git clone (general installation)

To install ComfyUI-Manager in addition to an existing installation of ComfyUI:

Navigate to ComfyUI/custom_nodes directory in terminal

Clone the repository:

git clone https://github.com/Comfy-Org/ComfyUI-Manager comfyui-manager

Install the manager dependencies:

cd comfyui-manager
pip install -r requirements.txt

Restart ComfyUI

Method 2: Portable version (Windows)

Install Git for Windows (standalone version, select “use windows default console window”)
Download install-manager-for-portable-version.bat into your ComfyUI_windows_portable directory
Double-click the batch file to install

Method 3: comfy-cli (recommended for new installations)

comfy-cli provides various features to manage ComfyUI from the CLI.Prerequisites: Python 3, GitWindows:

python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install

Linux/macOS:

python -m venv venv
. venv/bin/activate
pip install comfy-cli
comfy install

Get Started

Agent Tools

Basic Concepts

Interface Guide

Tutorials

Comfy Cloud Nodes

Partner Nodes

ComfyUI-Manager Installation

Desktop users

Portable users

Manual install users

Command line options

Switch between new and legacy UI

Updating ComfyUI-Manager

Legacy installation methods

​Desktop users

​Portable users

​Manual install users

​Command line options

​Switch between new and legacy UI

​Updating ComfyUI-Manager

​Legacy installation methods

Desktop users

Portable users

Manual install users

Command line options

Switch between new and legacy UI

Updating ComfyUI-Manager

Legacy installation methods