Skip to main content

Desktop users

If you’re using ComfyUI 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.
  1. Install the manager dependencies:
    .\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt
    
  2. 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.
  1. Activate your virtual environment:
    # Windows
    venv\Scripts\activate
    
    # Linux/macOS
    source venv/bin/activate
    
  2. Install the manager dependencies:
    pip install -r manager_requirements.txt
    
  3. Enable the manager with the --enable-manager flag when running ComfyUI:
    python main.py --enable-manager
    

Command line options

FlagDescription
--enable-managerEnable ComfyUI-Manager
--enable-manager-legacy-uiUse the legacy manager UI instead of the new UI (requires --enable-manager)
--disable-manager-uiDisable 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.
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

To install ComfyUI-Manager in addition to an existing installation of ComfyUI:
  1. Navigate to ComfyUI/custom_nodes directory in terminal
  2. Clone the repository:
    git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
    
  3. Install the manager dependencies:
    cd comfyui-manager
    pip install -r requirements.txt
    
  4. Restart ComfyUI
  1. Install Git for Windows (standalone version, select “use windows default console window”)
  2. Download install-manager-for-portable-version.bat into your ComfyUI_windows_portable directory
  3. Double-click the batch file to install
Prerequisites: python-is-python3, python3-venv, git
  1. Download install-comfyui-venv-linux.sh into an empty install directory
  2. Run:
    chmod +x install-comfyui-venv-linux.sh
    ./install-comfyui-venv-linux.sh
    
  3. 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