ComfyUI-Manager Installation

Desktop users

If you’re using Comfy Desktop, ComfyUI-Manager is already included and enabled by default. No additional installation is required.

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

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

See also: comfy-cli documentation

Method 4: Linux + venv

Prerequisites: python-is-python3, python3-venv, git

Download install-comfyui-venv-linux.sh into an empty install directory

Run:

chmod +x install-comfyui-venv-linux.sh
./install-comfyui-venv-linux.sh

Execute ComfyUI with ./run_gpu.sh or ./run_cpu.sh

Installation precautions:

ComfyUI-Manager files must be accurately located in the path ComfyUI/custom_nodes/comfyui-manager
Do not decompress directly into ComfyUI/custom_nodes (files like __init__.py should not be in that directory)
Do not install in paths like ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager or ComfyUI/custom_nodes/ComfyUI-Manager-main

​Desktop users

​Portable users

​Manual install users

​Command line options

​Switch between new and legacy UI

​Legacy installation methods

Desktop users

Portable users

Manual install users

Command line options

Switch between new and legacy UI

Legacy installation methods