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.
- V2.48.1: Security policy has been changed. Downloads of models in the list are allowed under the 'normal' security level.
- V2.47: Security policy has been changed. The former 'normal' is now 'normal-', and 'normal' no longer allows high-risk features, even if your ComfyUI is local.
- V2.37 Show a ✅ mark to accounts that have been active on GitHub for more than six months.
- V2.33 Security policy is applied.
- V2.21 cm-cli tool is added.
- V2.18 to V2.18.3 is not functioning due to a severe bug. Users on these versions are advised to promptly update to V2.18.4. Please navigate to the
ComfyUI/custom_nodes/ComfyUI-Managerdirectory and executegit pullto update. - You can see whole nodes info on ComfyUI Nodes Info page.
To install ComfyUI-Manager in addition to an existing installation of ComfyUI, you can follow the following steps:
- goto
ComfyUI/custom_nodesdir in terminal(cmd) git clone https://github.com/ltdrdata/ComfyUI-Manager.git- Restart ComfyUI
- install git
- https://git-scm.com/download/win
- standalone version
- select option: use windows default console window
- Download scripts/install-manager-for-portable-version.bat into installed
"ComfyUI_windows_portable"directory - double click
install-manager-for-portable-version.batbatch file
Installation[method3] (Installation through comfy-cli: install ComfyUI and ComfyUI-Manager at once.)
RECOMMENDED: comfy-cli provides various features to manage ComfyUI from the CLI.
- prerequisite: python 3, git
Windows:
python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install
Linux/OSX:
python -m venv venv
. venv/bin/activate
pip install comfy-cli
comfy install
To install ComfyUI with ComfyUI-Manager on Linux using a venv environment, you can follow these steps:
- prerequisite: python-is-python3, python3-venv, git
- 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.
chmod +x install-comfyui-venv-linux.sh./install-comfyui-venv-linux.sh
- DO:
ComfyUI-Managerfiles must be accurately located in the pathComfyUI/custom_nodes/ComfyUI-Manager- Installing in a compressed file format is not recommended.
- DON'T: Decompress directly into the
ComfyUI/custom_nodeslocation, resulting in the Manager contents like__init__.pybeing placed directly in that directory.- You have to remove all ComfyUI-Manager files from
ComfyUI/custom_nodes
- You have to remove all ComfyUI-Manager files from
- 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-ManagertoComfyUI/custom_nodes/ComfyUI-Manager
- You have to move
- DON'T: In a form where decompression occurs in a path such as
ComfyUI/custom_nodes/ComfyUI-Manager-main.- In such cases,
ComfyUI-Managermay operate, but it won't be recognized withinComfyUI-Manager, and updates cannot be performed. It also poses the risk of duplicate installations. - You have to rename
ComfyUI/custom_nodes/ComfyUI-Manager-maintoComfyUI/custom_nodes/ComfyUI-Manager
- In such cases,
You can execute ComfyUI by running either ./run_gpu.sh or ./run_cpu.sh depending on your system configuration.
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.
- 2.38
Install Custom Nodesmenu is changed toCustom Nodes Manager. - 2.21 cm-cli tool is added.
- 2.4 Copy the connections of the nearest node by double-clicking.
- 2.2.3 Support Components System
- 0.29 Add
Update allfeature - 0.25 support db channel
- You can directly modify the db channel settings in the
config.inifile. - If you want to maintain a new DB channel, please modify the
channels.listand submit a PR.
- You can directly modify the db channel settings in the
- 0.23 support multiple selection
- 0.18.1
skip update checkfeature 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.
-
Click "Manager" button on main menu
-
If you click on 'Install Custom Nodes' or 'Install Models', an installer dialog will open.
-
There are three DB modes:
DB: Channel (1day cache),DB: Local, andDB: 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.
Localuses 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.jsonand 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 Updatesmenu retrieves update data for custom nodes locally. Actual updates are applied by clicking theUpdatebutton in theInstall Custom Nodesmenu.
-
-
Click 'Install' or 'Try Install' button.
-
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
Channelindicator 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.
-
-
If you set the
Badge:item in the menu asBadge: 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: Nicknamedisplays the nickname of custom nodes, whileBadge: #ID Nicknamealso includes the internal ID of the node.
- When selecting (hide built-in), it hides the 🦊 icon, which signifies built-in nodes.
-
Share
- You can share the workflow by clicking the Share button at the bottom of the main menu or selecting Share Output from the Context Menu of the Image node.
- Currently, it supports sharing via https://comfyworkflows.com/, https://openart.ai, https://youml.com as well as through the Matrix channel.
- 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 menuAll: Show a dialog where the user can select a title for sharing.
- When you press
Save snapshotor useUpdate AllonManager Menu, the current installation status snapshot is saved.- Snapshot file dir:
ComfyUI-Manager/snapshots - You can rename snapshot file.
- Snapshot file dir:
- 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.- The selected snapshot file is saved in
ComfyUI-Manager/startup-scripts/restore-snapshot.json, and upon restarting ComfyUI, the snapshot is applied and then deleted.
- The selected snapshot file is saved in
- A tool is provided that allows you to use the features of ComfyUI-Manager without running ComfyUI.
- For more details, please refer to the cm-cli documentation.
- Add an entry to
custom-node-list.jsonlocated in the root of ComfyUI-Manager and submit a Pull Request. - NOTE: Before submitting the PR after making changes, please check
Use local DBand ensure that the extension list loads without any issues in theInstall custom nodesdialog. 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.
-
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.
NODE_CLASS_MAPPINGS = {
"ExecutionSwitch": ExecutionSwitch,
"ExecutionBlocker": ExecutionBlocker,
...
}
NODE_CLASS_MAPPINGS.update({
"UniFormer-SemSegPreprocessor": Uniformer_SemSegPreprocessor,
"SemSegPreprocessor": Uniformer_SemSegPreprocessor,
})
-
Or you can provide manually
node_list.jsonfile. -
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
nicknameis being used, but other parts will also be utilized in the future. - The
nicknamewill 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.
- Currently, only the
"""
@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 automaticallyinstall.py- When installing, it is automatically calleduninstall.py- When uninstalling, it is automatically calleddisable.py- When disabled, it is automatically called- When installing a custom node setup
.jsfile, it is recommended to write this script for disabling.
- When installing a custom node setup
enable.py- When enabled, it is automatically called- All scripts are executed from the root path of the corresponding custom node.
-
Copy & Paste
- Demo Page
- When pasting a component from the clipboard, it supports text in the following JSON format. (text/plain)
{ "kind": "ComfyUI Components", "timestamp": <current timestamp>, "components": { <component name>: <component nodedata> } } <current timestamp>Ensure that the timestamp is always unique.- "components" should have the same structure as the content of the file stored in ComfyUI-Manager/components.
<component name>: The name should be in the format<prefix>::<node name>.<compnent nodeata>: In the nodedata of the group node.<version>: Only two formats are allowed:major.minor.patchormajor.minor. (e.g.1.0,2.2.1)<datetime>: Saved time<packname>: If the packname is not empty, the category becomes packname/workflow, and it is saved in the .pack file in ComfyUI-Manager/components.<category>: If there is neither a category nor a packname, it is saved in the components category.
"version":"1.0", "datetime": 1705390656516, "packname": "mypack", "category": "util/pipe",
- "components" should have the same structure as the content of the file stored in ComfyUI-Manager/components.
-
Drag & Drop
- Dragging and dropping a
.packor.jsonfile will add the corresponding components. - Example pack: Impact.pack
- Dragging and dropping a
-
Dragging and dropping or pasting a single component will add a node. However, when adding multiple components, nodes will not be added.
- When you click on the
Install Missing Custom Nodesbutton in the menu, it displays a list of extension nodes that contain nodes not currently present in the workflow.
-
Logging to file feature
- This feature is enabled by default and can be disabled by setting
file_logging = Falsein theconfig.ini.
- This feature is enabled by default and can be disabled by setting
-
Fix node(recreate): When right-clicking on a node and selecting
Fix node (recreate), you can recreate the node. The widget's values are reset, while the connections maintain those with the same names.- It is used to correct errors in nodes of old workflows created before, which are incompatible with the version changes of custom nodes.
-
Double-Click Node Title: You can set the double click behavior of nodes in the ComfyUI-Manager menu.
-
Copy All Connections,Copy Input Connections: Double-clicking a node copies the connections of the nearest node.- This action targets the nearest node within a straight-line distance of 1000 pixels from the center of the node.
- In the case of
Copy All Connections, it duplicates existing outputs, but since it does not allow duplicate connections, the existing output connections of the original node are disconnected. - This feature copies only the input and output that match the names.
-
Possible Input Connections: It connects all outputs that match the closest type within the specified range.- This connection links to the closest outputs among the nodes located on the left side of the target node.
-
Possible(left) + Copy(right): When you Double-Click on the left half of the title, it operates asPossible Input Connections, and when you Double-Click on the right half, it operates asCopy All Connections.
-
-
Prevent downgrade of specific packages
- List the package names in the
downgrade_blacklistsection of theconfig.inifile, separating them with commas.- e.g
downgrade_blacklist = diffusers, kornia
- List the package names in the
-
Custom pip mapping
- When you create the
pip_overrides.jsonfile, it changes the installation of specific pip packages to installations defined by the user.- Please refer to the
pip_overrides.json.templatefile.
- Please refer to the
- When you create the
-
Use
aria2as downloader
When you run the scan.sh script:
-
It updates the
extension-node-map.json.- To do this, it pulls or clones the custom nodes listed in
custom-node-list.jsoninto~/.tmp/default. - To skip this step, add the
--skip-updateoption. - If you want to specify a different path instead of
~/.tmp/default, runpython scanner.py [path]directly instead ofscan.sh.
- To do this, it pulls or clones the custom nodes listed in
-
It updates the
github-stats.json.- This uses the GitHub API, so set your token with
export GITHUB_TOKEN=your_token_hereto avoid quickly reaching the rate limit and malfunctioning. - To skip this step, add the
--skip-update-statoption.
- This uses the GitHub API, so set your token with
-
The
--skip-alloption applies both--skip-updateand--skip-stat-update.
- If your
git.exeis installed in a specific location other than system git, please install ComfyUI-Manager and run ComfyUI. Then, specify the path including the file name ingit_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
PreviewTextNodefromComfyUI_Custom_Nodes_AlekPetare only supported as front-end nodes, we currently do not provide missing nodes for them. - Currently,
vid2vidis not being updated, causing compatibility issues. - If you encounter the error message
Overlapped Object has pending operation at deallocation on Comfyui Manager loadunder Windows- Edit
config.inifile: addwindows_selector_event_loop_policy = True
- Edit
- if
SSL: CERTIFICATE_VERIFY_FAILEDerror is occured.- Edit
config.inifile: addbypass_ssl = True
- Edit
-
Edit
config.inifile: addsecurity_level = <LEVEL>strong- doesn't allow
highandmiddlelevel risky feature
- doesn't allow
normal- doesn't allow
highlevel risky feature middlelevel risky feature is available
- doesn't allow
normal-- doesn't allow
highlevel risky feature if--listenis specified and not starts with127. middlelevel risky feature is available
- doesn't allow
weak- all feature is available
-
highlevel risky featuresInstall via git url,pip install- Installation of custom nodes registered not in the
default channel. - Display terminal log
-
middlelevel risky features- Uninstall/Update/Fix custom nodes
- Installation of custom nodes registered in the
default channel. - Restore/Remove Snapshot
- Restart
-
lowlevel risky features- Update ComfyUI
- https://github.com/diontimmer/Sample-Diffusion-ComfyUI-Extension
- https://github.com/senshilabs/NINJA-plugin
- https://github.com/MockbaTheBorg/Nodes
- https://github.com/StartHua/Comfyui_GPT_Story
- https://github.com/NielsGercama/comfyui_customsampling
- https://github.com/wrightdaniel2017/ComfyUI-VideoLipSync
- https://github.com/bxdsjs/ComfyUI-Image-preprocessing
- https://github.com/SMUELDigital/ComfyUI-ONSET
- https://github.com/SimithWang/comfyui-renameImages
- https://github.com/icefairy64/comfyui-model-tilt
- https://github.com/andrewharp/ComfyUI-EasyNodes
- https://github.com/SimithWang/comfyui-renameImages
- https://github.com/Tcheko243/ComfyUI-Photographer-Alpha7-Nodes
- https://github.com/Limbicnation/ComfyUINodeToolbox
- https://github.com/chenpipi0807/pip_longsize
- https://github.com/APZmedia/ComfyUI-APZmedia-srtTools
- 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.
- Template sharing system. (-> Component system based on Group Nodes)
- 3rd party API system.
- Auto migration for custom nodes with changed structures.
- Version control feature for nodes.
- List of currently used custom nodes.
- Download support multiple model download.
- Model download via url.
- List sorting (custom nodes).
- List sorting (model).
- Provides description of node.
- This extension simply provides the convenience of installing custom nodes and does not guarantee their proper functioning.
ComfyUI/ComfyUI - A powerful and modular stable diffusion GUI.
And, for all ComfyUI custom node developers
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent