ComfyUI插件管家:3分钟学会智能管理AI绘画工具集
ComfyUI插件管家:3分钟学会智能管理AI绘画工具集
【免费下载链接】ComfyUI-Manager 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
ComfyUI-Manager是一款专为增强ComfyUI可用性设计的扩展工具,提供了安装、移除、禁用和启用各种自定义节点的管理功能,还具备中心功能和便捷操作,帮助用户轻松访问ComfyUI内的各类信息。
快速安装指南:4种方法任选
方法1:通用安装(仅ComfyUI-Manager)
- 在终端(cmd)中进入
ComfyUI/custom_nodes目录 - 执行命令:
git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager comfyui-manager - 重启ComfyUI
方法2:便携版安装(仅ComfyUI-Manager)
- 安装git(https://git-scm.com/download/win)
- 下载scripts/install-manager-for-portable-version.bat到"ComfyUI_windows_portable"目录
- 双击运行
install-manager-for-portable-version.bat
方法3:通过comfy-cli安装(推荐)
推荐:comfy-cli提供了从命令行管理ComfyUI的各种功能。
前提条件:python 3, git
Windows系统:
python -m venv venv venv\Scripts\activate pip install comfy-cli comfy install Linux/macOS系统:
python -m venv venv . venv/bin/activate pip install comfy-cli comfy install 方法4:Linux+venv安装(ComfyUI + ComfyUI-Manager)
- 下载scripts/install-comfyui-venv-linux.sh到空的安装目录
- 执行命令:
chmod +x install-comfyui-venv-linux.sh - 运行脚本:
./install-comfyui-venv-linux.sh
安装注意事项
- 必须:
ComfyUI-Manager文件必须准确位于路径ComfyUI/custom_nodes/comfyui-manager- 不建议以压缩文件格式安装。
- 禁止:直接解压到
ComfyUI/custom_nodes位置,导致Manager内容如__init__.py直接放置在该目录中。- 必须从
ComfyUI/custom_nodes中删除所有ComfyUI-Manager文件
- 必须从
- 禁止:以
ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager等路径解压。 - 禁止:以
ComfyUI/custom_nodes/ComfyUI-Manager-main等路径解压。- 在这种情况下,
ComfyUI-Manager可能会运行,但在ComfyUI-Manager中无法识别,也无法执行更新。还存在重复安装的风险。请删除它并通过git clone方法正确安装。
- 在这种情况下,
您可以通过运行./run_gpu.sh或./run_cpu.sh来启动ComfyUI,具体取决于您的系统配置。
快速使用指南
- 点击主菜单上的"Manager"按钮
- 点击"Install Custom Nodes"或"Install Models",将打开安装器对话框。
- 有三种数据库模式:
DB: Channel (1day cache)、DB: Local和DB: Channel (remote)。Channel (1day cache)利用有效期为一天的Channel缓存信息来快速显示列表。- 当没有缓存、缓存过期或通过Channel(远程)检索外部信息时,此信息将更新。
- 每当您重新启动ComfyUI时,此模式始终设置为默认模式。
Local使用ComfyUI-Manager中本地存储的信息。- 此信息仅在更新ComfyUI-Manager时更新。
- 对于自定义节点开发人员,在
custom-node-list.json中注册节点并测试时应使用此模式。
Channel (remote)从远程通道检索信息,始终显示最新列表。- 如果由于网络错误无法检索,将强制使用本地信息。
Fetch Updates菜单检索本地自定义节点的更新数据。实际更新通过点击Install Custom Nodes菜单中的Update按钮应用。
- 有三种数据库模式:
- 点击"Install"或"Try Install"按钮。
- 已安装:此项已安装。
- 安装:点击此按钮将安装该项。
- 尝试安装:这是无法确认安装信息的自定义节点。点击按钮尝试安装。
- 如果顶部出现红色背景的
Channel指示器,则表示它不是默认通道。由于持有的信息量与默认通道不同,在此通道状态下可能不会显示许多自定义节点。- 通道设置影响广泛,不仅影响节点列表,还影响"全部更新"等所有功能。
- 黄色背景的冲突节点显示了与其他扩展冲突的节点列表。此问题需要开发人员解决,用户应注意由于这些冲突,某些节点可能无法正常运行,可能需要相应安装。
- 分享功能
- 您可以通过点击主菜单底部的"Share"按钮或从Image节点的上下文菜单中选择"Share Output"来分享工作流。
- 目前支持通过多种平台分享,以及通过Matrix频道分享。
- 通过Manager菜单中的Share设置,您可以配置主菜单中的Share按钮或上下文菜单上的Share Output按钮的行为。
None:从主菜单隐藏All:显示一个对话框,用户可以选择分享标题。
实用功能介绍
快照管理
- 当您按下
Save snapshot或在Manager Menu上使用Update All时,将保存当前安装状态快照。- 快照文件目录:
<USER_DIRECTORY>/default/ComfyUI-Manager/snapshots - 您可以重命名快照文件。
- 快照文件目录:
- 按下"Restore"按钮可恢复到相应快照的安装状态。
- 但是,对于非Git管理的自定义节点,快照支持不完整。
- 当您按下
Restore时,将在下次ComfyUI启动时生效。- 所选快照文件保存在
<USER_DIRECTORY>/default/ComfyUI-Manager/startup-scripts/restore-snapshot.json中,重启ComfyUI后应用快照并删除该文件。
- 所选快照文件保存在
命令行工具:cm-cli
- 提供了无需运行ComfyUI即可使用ComfyUI-Manager功能的工具。
- 有关更多详细信息,请参阅cm-cli文档。
安装缺失节点支持
- 当您点击菜单中的
Install Missing Custom Nodes按钮时,它会显示工作流中当前不存在的扩展节点列表。
配置指南
您可以修改config.ini文件来应用ComfyUI-Manager的设置。
- ComfyUI-Manager使用的
config.ini路径显示在启动日志消息中。 - 另请参见:路径部分
配置选项:
[default] git_exe = <手动指定git可执行文件的路径。如果留空,将使用默认的git可执行文件路径。> use_uv = <使用uv代替pip进行依赖安装。> default_cache_as_channel_url = <确定是否在启动时检索指定为channel_url的数据库> bypass_ssl = <如果发生SSL错误,设置为True以禁用SSL。> file_logging = <配置是否创建ComfyUI-Manager使用的日志文件。> windows_selector_event_loop_policy = <如果在Windows上发生事件循环错误,将此设置为True。> model_download_by_agent = <下载模型时,使用代理而不是torchvision_download_url。> downgrade_blacklist = <设置防止降级的软件包列表。用逗号分隔。> security_level = <设置安全级别 => strong|normal|normal-|weak> always_lazy_install = <是否即使在Windows以外的环境中也在重启时执行依赖安装。> network_mode = <设置网络模式 => public|private|offline> network_mode:
- public: 使用典型公共网络的环境。
- private: 使用封闭网络的环境,其中通过
channel_url配置私有节点数据库。(如果有缓存则使用缓存) - offline: 使用离线网络时不使用任何外部连接的环境。(如果有缓存则使用缓存)
额外功能
- 文件日志功能
- 此功能默认启用,可以通过在
config.ini中设置file_logging = False来禁用。
- 此功能默认启用,可以通过在
- 修复节点(重新创建):右键点击节点并选择
Fix node (recreate),您可以重新创建节点。小部件的值被重置,而连接保持具有相同名称的连接。- 用于纠正以前创建的旧工作流中与自定义节点版本更改不兼容的节点错误。
- 双击节点标题:您可以在ComfyUI-Manager菜单中设置节点的双击行为。
Copy All Connections,Copy Input Connections:双击节点复制最近节点的连接。- 此操作针对距离节点中心直线距离1000像素内的最近节点。
- 在
Copy All Connections的情况下,它会复制现有输出,但由于不允许重复连接,原始节点的现有输出连接将断开。 - 此功能仅复制名称匹配的输入和输出。
Possible Input Connections:它连接指定范围内所有匹配最接近类型的输出。- 此连接链接到位于目标节点左侧的节点中最近的输出。
Possible(left) + Copy(right):双击标题的左半部分时,它作为Possible Input Connections运行,双击右半部分时,它作为Copy All Connections运行。
- 防止特定软件包降级
- 例如
- 自定义pip映射
- 当您创建
pip_overrides.json文件时,它会将特定pip软件包的安装更改为用户定义的安装。- 请参考
pip_overrides.json.template文件。
- 请参考
- 当您创建
- 防止安装特定pip软件包
- 在
pip_blacklist.list文件中每行列出一个软件包名称。
- 在
- 自动恢复pip安装
- 如果在
pip_auto_fix.list中列出pip规范要求,类似于requirements.txt,则在启动ComfyUI时或在各种自定义节点安装过程中版本不匹配时,将自动恢复指定的版本。 - 可以使用
--index-url。 - 使用
aria2作为下载器
在config.ini文件的downgrade_blacklist部分列出软件包名称,用逗号分隔。
downgrade_blacklist = diffusers, kornia 环境变量
可以使用环境变量配置以下功能:
- COMFYUI_PATH:ComfyUI的安装路径
- GITHUB_ENDPOINT:对GitHub访问受限环境的反向代理配置
- HF_ENDPOINT:对Hugging Face访问受限环境的反向代理配置
示例1:
将https://github.com/ltdrdata/ComfyUI-Impact-Pack重定向到https://mirror.ghproxy.com/https://github.com/ltdrdata/ComfyUI-Impact-Pack
GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com 示例2:
将https://huggingface.co/path/to/somewhere更改为https://some-hf-mirror.com/path/to/somewhere
HF_ENDPOINT=https://some-hf-mirror.com 故障排除
- 如果您的
git.exe安装在系统git以外的特定位置,请安装ComfyUI-Manager并运行ComfyUI。然后,在生成的<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini文件中的git_exe =中指定包含文件名的路径。 - 如果ComfyUI-Manager本身更新失败,请转到ComfyUI-Manager目录并执行命令
git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull。 - 如果在Windows下遇到错误消息
Overlapped Object has pending operation at deallocation on ComfyUI Manager load- 编辑
config.ini文件:添加windows_selector_event_loop_policy = True
- 编辑
- 如果发生
SSL: CERTIFICATE_VERIFY_FAILED错误。- 编辑
config.ini文件:添加bypass_ssl = True
- 编辑
安全策略
- 编辑
config.ini文件:添加security_level = <LEVEL>strong- 不允许
high和middle级别的风险功能
- 不允许
normal- 不允许
high级别的风险功能 middle级别的风险功能可用
- 不允许
normal-- 如果指定
--listen且不以127.开头,则不允许high级别的风险功能 middle级别的风险功能可用
- 如果指定
weak- 所有功能可用
high级别风险功能Install via git url,pip install- 安装未在
default channel中注册的自定义节点。 - 修复自定义节点
middle级别风险功能- 卸载/更新
- 安装在
default channel中注册的自定义节点。 - 恢复/删除快照
- 重启
low级别风险功能- 更新ComfyUI
免责声明
- 此扩展仅提供安装自定义节点的便利,不保证其正常运行。
鸣谢
ComfyUI/ComfyUI - 一个强大且模块化的稳定扩散GUI。
以及所有ComfyUI自定义节点开发人员
【免费下载链接】ComfyUI-Manager 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager