/ComfyUI-Manager

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

ComfyUI Manager

ComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.

menu

NOTICE

  • 🏆 Join us for the ComfyUI Workflow Contest, hosted by OpenArt AI (11.27.2023 - 12.15.2023). Our esteemed judge panel includes Scott E. Detweiler, Olivio Sarikas, MERJIC麦橘, among others. We're also thrilled to have the authors of ComfyUI Manager and AnimateDiff as our special guests!
  • If you wish to hide the "Share" button, click "Manager" and choose "Share: None" option.
  • You can see whole nodes info on ComfyUI Nodes Info page.
  • Versions prior to V0.22.2 will no longer detect missing nodes unless using a local database. Please update ComfyUI-Manager to the latest version.

Installation

Installation[method1] (General installation method: ComfyUI-Manager only)

To install ComfyUI-Manager in addition to an existing installation of ComfyUI, you can follow the following steps:

  1. cd custom_nodes
  2. git clone https://github.com/ltdrdata/ComfyUI-Manager.git
  3. Restart ComfyUI

Installation[method2] (Installation for portable ComfyUI version: ComfyUI-Manager only)

  1. install git
  1. Download scripts/install-manager-for-portable-version.bat into installed "ComfyUI_windows_portable" directory
  2. double click install-manager-for-portable-version.bat batch file

portable-install

Installation[method3] (Installation for linux+venv: ComfyUI + ComfyUI-Manager)

To install ComfyUI with ComfyUI-Manager on Linux using a venv environment, you can follow these steps: prerequisite: python-is-python3, python3-venv

  1. Download scripts/install-comfyui-venv-linux.sh into empty install directory
  • ComfyUI will be installed in the subdirectory of the specified directory, and the directory will contain the generated executable script.
  1. chmod +x install-comfyui-venv-linux.sh
  2. ./install-comfyui-venv-linux.sh

Installation Precautions

  • DO: ComfyUI-Manager files must be accurately located in the path ComfyUI/custom_nodes/ComfyUI-Manager
    • Installing in a compressed file format is not recommended.
  • DON'T: Decompress directly into the ComfyUI/custom_nodes location, resulting in the Manager contents like __init__.py being placed directly in that directory.
    • You have to remove all ComfyUI-Manager files from ComfyUI/custom_nodes
  • DON'T: In a form where decompression occurs in a path such as ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager.
    • You have to move ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager to ComfyUI/custom_nodes/ComfyUI-Manager
  • DON'T: In a form where decompression occurs in a path such as ComfyUI/custom_nodes/ComfyUI-Manager-main.
    • In such cases, ComfyUI-Manager may operate, but it won't be recognized within ComfyUI-Manager, and updates cannot be performed. It also poses the risk of duplicate installations.
    • You have to rename ComfyUI/custom_nodes/ComfyUI-Manager-main to ComfyUI/custom_nodes/ComfyUI-Manager

You can execute ComfyUI by running either ./run_gpu.sh or ./run_cpu.sh depending on your system configuration.

Colab Notebook

This repository provides Colab notebooks that allow you to install and use ComfyUI, including ComfyUI-Manager. To use ComfyUI, click on this link.

  • Support for installing ComfyUI
  • Support for basic installation of ComfyUI-Manager
  • Support for automatically installing dependencies of custom nodes upon restarting Colab notebooks.

Changes

  • 0.29 Add Update all feature
  • 0.25 support db channel
    • You can directly modify the db channel settings in the config.ini file.
    • If you want to maintain a new DB channel, please modify the channels.list and submit a PR.
  • 0.23 support multiple selection
  • 0.18.1 skip update check feature added.
    • A feature that allows quickly opening windows in environments where update checks take a long time.
  • 0.17.1 Bug fix for the issue where enable/disable of the web extension was not working. Compatibility patch for StableSwarmUI.
    • Requires latest version of ComfyUI (Revision: 1240)
  • 0.17 Support preview method setting feature.
  • 0.14 Support robust update.
  • 0.13 Support additional 'pip' section for install spec.
  • 0.12 Better installation support for Windows.
  • 0.9 Support keyword search in installer menu.
  • V0.7.1 Bug fix for the issue where updates were not being applied on Windows.
    • For those who have been using versions 0.6, please perform a manual git pull in the custom_nodes/ComfyUI-Manager directory.
  • V0.7 To address the issue of a slow list refresh, separate the fetch update and update check processes.
  • V0.6 Support extension installation for missing nodes.
  • V0.5 Removed external git program dependencies.

How To Use

  1. Click "Manager" button on main menu

    mainmenu

  2. If you click on 'Install Custom Nodes' or 'Install Models', an installer dialog will open.

    menu

    • There are three DB modes: DB: Channel (1day cache), DB: Local, and DB: Channel (remote).

      • Channel (1day cache) utilizes Channel cache information with a validity period of one day to quickly display the list.
        • This information will be updated when there is no cache, when the cache expires, or when external information is retrieved through the Channel (remote).
        • Whenever you start ComfyUI anew, this mode is always set as the default mode.
      • Local uses information stored locally in ComfyUI-Manager.
        • This information will be updated only when you update ComfyUI-Manager.
        • For custom node developers, they should use this mode when registering their nodes in custom-node-list.json and testing them.
      • Channel (remote) retrieves information from the remote channel, always displaying the latest list.
      • In cases where retrieval is not possible due to network errors, it will forcibly use local information.
    • The Fetch Updates menu retrieves update data for custom nodes locally. Actual updates are applied by clicking the Update button in the Install Custom Nodes menu.

  3. Click 'Install' or 'Try Install' button.

    node-install-dialog

    model-install-dialog

    • Installed: This item is already installed.

    • Install: Clicking this button will install the item.

    • Try Install: This is a custom node of which installation information cannot be confirmed. Click the button to try installing it.

    • If a red background Channel indicator appears at the top, it means it is not the default channel. Since the amount of information held is different from the default channel, many custom nodes may not appear in this channel state.

      • Channel settings have a broad impact, affecting not only the node list but also all functions like "Update all."
    • Conflicted Nodes with a yellow background show a list of nodes conflicting with other extensions in the respective extension. This issue needs to be addressed by the developer, and users should be aware that due to these conflicts, some nodes may not function correctly and may need to be installed accordingly.

  4. If you set the Badge: item in the menu as Badge: Nickname, Badge: Nickname (hide built-in), Badge: #ID Nickname, Badge: #ID Nickname (hide built-in) the information badge will be displayed on the node.

    • When selecting (hide built-in), it hides the 🦊 icon, which signifies built-in nodes.
      • Nodes without any indication on the badge are custom nodes that Manager cannot recognize.
    • Badge: Nickname displays the nickname of custom nodes, while Badge: #ID Nickname also includes the internal ID of the node.

    model-install-dialog

  5. Share menu share

menu

  • Through the Share settings in the Manager menu, you can configure the behavior of the Share button in the Main menu or Share Ouput button on Context Menu.
    • None: hide from Main menu
    • All: Show a dialog where the user can select a title for sharing.

Snapshot-Manager

  • When you press Save snapshot or use Update All on Manager Menu, the current installation status snapshot is saved.
    • Snapshot file dir: ComfyUI-Manager/snapshots
    • You can rename snapshot file.
  • Press the "Restore" button to revert to the installation status of the respective snapshot.
    • However, for custom nodes not managed by Git, snapshot support is incomplete.
  • When you press Restore, it will take effect on the next ComfyUI startup.

model-install-dialog

How to register your custom node into ComfyUI-Manager

  • Add an entry to custom-node-list.json located in the root of ComfyUI-Manager and submit a Pull Request.
  • NOTE: Before submitting the PR after making changes, please check Use local DB and ensure that the extension list loads without any issues in the Install custom nodes dialog. Occasionally, missing or extra commas can lead to JSON syntax errors.
  • The remaining JSON will be updated through scripts in the future, so you don't need to worry about it.

Custom node support guide

  • Currently, the system operates by cloning the git repository and sequentially installing the dependencies listed in requirements.txt using pip, followed by invoking the install.py script. In the future, we plan to discuss and determine the specifications for supporting custom nodes.

  • Please submit a pull request to update either the custom-node-list.json or model-list.json file.

  • The scanner currently provides a detection function for missing nodes, which is capable of detecting nodes described by the following two patterns.

    • Or you can provide manually node_list.json file.
NODE_CLASS_MAPPINGS = {
    "ExecutionSwitch": ExecutionSwitch,
    "ExecutionBlocker": ExecutionBlocker,
    ...
}

NODE_CLASS_MAPPINGS.update({
    "UniFormer-SemSegPreprocessor": Uniformer_SemSegPreprocessor,
    "SemSegPreprocessor": Uniformer_SemSegPreprocessor,
})
  • When you write a docstring in the header of the .py file for the Node as follows, it will be used for managing the database in the Manager.
    • Currently, only the nickname is being used, but other parts will also be utilized in the future.
    • The nickname will be the name displayed on the badge of the node.
    • If there is no nickname, it will be truncated to 20 characters from the arbitrarily written title and used.
"""
@author: Dr.Lt.Data
@title: Impact Pack
@nickname: Impact Pack
@description: This extension offers various detector nodes and detailer nodes that allow you to configure a workflow that automatically enhances facial details. And provide iterative upscaler.
"""
  • Special purpose files (optional)
    • node_list.json - When your custom nodes pattern of NODE_CLASS_MAPPINGS is not conventional, it is used to manually provide a list of nodes for reference. (example)
    • requirements.txt - When installing, this pip requirements will be installed automatically
    • install.py - When installing, it is automatically called
    • uninstall.py - When uninstalling, it is automatically called
    • disable.py - When disabled, it is automatically called
      • When installing a custom node setup .js file, it is recommended to write this script for disabling.
    • enable.py - When enabled, it is automatically called
    • All scripts are executed from the root path of the corresponding custom node.

Support of missing nodes installation

missing-menu

  • When you click on the Install Missing Custom Nodes button in the menu, it displays a list of extension nodes that contain nodes not currently present in the workflow.

missing-list

Troubleshooting

  • If your git.exe is installed in a specific location other than system git, please install ComfyUI-Manager and run ComfyUI. Then, specify the path including the file name in git_exe = in the ComfyUI-Manager/config.ini file that is generated.
  • If updating ComfyUI-Manager itself fails, please go to the ComfyUI-Manager directory and execute the command git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull.
  • Alternatively, download the update-fix.py script from update-fix.py and place it in the ComfyUI-Manager directory. Then, run it using your Python command. For the portable version, use ..\..\..\python_embeded\python.exe update-fix.py.
  • For cases where nodes like PreviewTextNode from ComfyUI_Custom_Nodes_AlekPet are only supported as front-end nodes, we currently do not provide missing nodes for them.
  • Currently, vid2vid is not being updated, causing compatibility issues.

TODO: Unconventional form of custom node list

Roadmap

  • System displaying information about failed custom nodes import.
  • Guide for missing nodes in ComfyUI vanilla nodes.
  • Collision checking system for nodes with the same ID across extensions.
  • Auto migration for custom nodes with changed structures.
  • Version control feature for nodes.
  • List of currently used custom nodes.
  • Template sharing system.
  • 3rd party API system.
  • Download support multiple model download.
  • Model download via url.
  • List sorting.
  • Provides description of node.

Disclaimer

  • This extension simply provides the convenience of installing custom nodes and does not guarantee their proper functioning.

Credit

ComfyUI/ComfyUI - A powerful and modular stable diffusion GUI.

And, for all ComfyUI custom node developers