Skip to main content

Prerequisites

  • Python 3
  • Git

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. Restart ComfyUI

Method 2: Portable ComfyUI version (Windows)

  1. Install Git for Windows
    • Use standalone version
    • Select option: “use windows default console window”
  2. Download install-manager-for-portable-version.bat into your ComfyUI_windows_portable directory
    • Right-click the link and choose “Save As…”
  3. Double-click install-manager-for-portable-version.bat
comfy-cli provides various features to manage ComfyUI from the CLI and installs both ComfyUI and ComfyUI-Manager at once.
  • Windows
  • Linux/macOS
python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install
See also: comfy-cli documentation

Method 4: Linux with venv

Prerequisites: python-is-python3, python3-venv, git
  1. Download install-comfyui-venv-linux.sh into an empty install directory
    • Right-click the link and choose “Save As…”
  2. Make executable and run:
    chmod +x install-comfyui-venv-linux.sh
    ./install-comfyui-venv-linux.sh
    
You can execute ComfyUI by running either ./run_gpu.sh or ./run_cpu.sh depending on your system configuration.

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 location, resulting in Manager contents like __init__.py being placed directly in that directory
  • Install in a path like ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager
  • Install in a path like ComfyUI/custom_nodes/ComfyUI-Manager-main
If installed incorrectly, ComfyUI-Manager may operate but won’t be recognized for updates and poses the risk of duplicate installations. Remove it and install properly via git clone method.

Google Colab

Use the Colab notebook to run ComfyUI with ComfyUI-Manager:
  • Supports installing ComfyUI
  • Supports basic installation of ComfyUI-Manager
  • Automatically installs dependencies of custom nodes upon restarting Colab notebooks