ComfyUI Manager

4.1 · active · verified Tue Apr 14

ComfyUI Manager is an extension designed to enhance the usability of ComfyUI by providing features to install, update, remove, disable, and enable custom nodes and models. It also offers various functionalities to assist with ComfyUI workflows, including snapshot management and missing node detection. The current version is 4.1, and it follows the release cadence of ComfyUI, with frequent updates.

Warnings

breaking ComfyUI Manager underwent significant integration changes with ComfyUI, particularly around ComfyUI v0.4.0. The Manager button might disappear, and it now requires the `--enable-manager` flag at ComfyUI launch. Older installations might break if ComfyUI is updated without enabling the manager or migrating configuration.
Fix: Ensure ComfyUI is launched with `python main.py --enable-manager`. For users of portable ComfyUI, update `manager_requirements.txt` and launch with specific portable commands.
breaking In ComfyUI-Manager v3.38, a security patch migrated manager data to a protected path. This change could break configurations relying on older, unprotected paths.
Fix: Review the migration guide on the official GitHub page for details on adjusting paths, especially if upgrading from much older versions.
gotcha Incorrect installation path for `git clone` can lead to the Manager not being recognized or updated properly. Common mistakes include double-nested folders (`ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager`) or incorrect folder names (`ComfyUI/custom_nodes/ComfyUI-Manager-main`).
Fix: Ensure `comfyui-manager` files are located precisely in `ComfyUI/custom_nodes/comfyui-manager`. Remove any incorrectly installed versions and reinstall.
gotcha Users might encounter `KeyError: 'reference'` or 'Failed to get Custom Nodes' errors when opening the manager, indicating an outdated ComfyUI Manager installation.
Fix: Navigate to the `ComfyUI/custom_nodes/ComfyUI-Manager` directory and run `git pull` to update the manager. Then, restart ComfyUI.
gotcha If ComfyUI Manager does not appear after installation (especially for non-Desktop versions), ensure Git is installed and accessible in your system's PATH. Manager relies on Git for cloning and updating custom nodes.
Fix: Install Git for your operating system (e.g., Git for Windows) and ensure it's correctly added to your system's PATH environment variable. Restart ComfyUI.

Install

pip install comfyui-manager PyPI installation (recommended for latest features)
cd ComfyUI/custom_nodes git clone https://github.com/ltdrdata/ComfyUI-Manager.git comfyui-manager Git clone installation (legacy, may not support all new features)

Imports

ComfyUI Manager
```
ComfyUI Manager is primarily an extension integrated into ComfyUI. Direct programmatic imports for general end-user functionality are not its typical use case. Users interact with it via the ComfyUI GUI or its command-line interface (cm-cli).
```
ComfyUI Manager is designed as an extension/plugin for the ComfyUI application, not as a standalone Python library for direct import into arbitrary Python scripts. Its functionality is exposed through ComfyUI's user interface or a dedicated CLI tool.

Quickstart

After installing `comfyui-manager` via pip, launch your ComfyUI instance with the `--enable-manager` flag. This will enable the ComfyUI Manager interface within the ComfyUI application. For programmatic management outside the UI, the `cm-cli.py` tool located within the `ComfyUI/custom_nodes/ComfyUI-Manager` directory can be used to perform tasks like updating custom nodes.

# 1. Install ComfyUI-Manager via pip (recommended)
pip install comfyui-manager

# 2. Launch ComfyUI with the manager enabled
# (Ensure you are in your ComfyUI root directory or have activated its Python environment)
python main.py --enable-manager

# Optional: Use the command-line interface (cm-cli) for management tasks
# (Execute from your ComfyUI root directory)
# python custom_nodes/ComfyUI-Manager/cm-cli.py update all
# For portable Windows builds:
# .\python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Manager\cm-cli.py update all

view raw JSON →