ComfyUI 自定义节点(插件)安装及更新教程
ComfyUI 自定义节点(插件)安装及更新教程
本文将详细介绍ComfyUI自定义节点(插件)的多种安装方式,包括ComfyUI Manager安装、Git安装、手动安装、秋叶启动器安装等,并提供了针对中国用户的特殊解决方案。
ComfyUI 自定义节点(插件)安装及更新教程
本文将以ComfyUI-Manager安装为例进行讲解。
https://github.com/ltdrdata/ComfyUI-Manager.git
ComfyUI Manager是一个实用的插件,它可以帮你自动安装插件,下载模型等等,你可以把这个插件当成一个大的资源库,你可以随时使用它来进行下载内容,不过如果你在中国国内,可能会因为网络访问问题,导致下载体验不佳,但是ComfyUI Manager可以方便我们日常的ComfyUI的使用,查找缺失节点等等
本文会涉及以下集中插件安装方式:
- ComfyUI Manager安装插件(推荐)
- Git安装:使用Git命令进行安装
- 手动安装:压缩包手动安装ComfyUI插件插件
- 秋叶启动器安装插件
- 中国境内使用Gitee克隆Github插件仓库
以上的这几种方式,除了手动安装,其实基本上都是通过Git来进行安装的,只不过使用了不同的方式来使用Git,但是在中国境内对于Github的访问可能存在问题,所以在文章最后我也会补充介绍在中国境内如何把对应插件仓库的克隆到类似Gitee这样的平台来进行安装
然后通常在安装完节点之后还需要进行对应的依赖安装,每个自定义节点都存在一个
requirements.txt
文件包含了对应节点的需要的python依赖,在我们完成所有的安装方式的讲解后,我们统一来讲解如何进行不同自定义节点依赖的安装。
💡
目前ComfyUI Desktop已经预装了ComfyUI Manager插件,所以你不需要再手动这个插件,如果你的网络环境没有问题,我都建议你使用ComfyUI Manager来安装插件
一、使用ComfyUI Manager安装插件
1.ComfyUI Manager新版本菜单入口位置
如图所示如果你的ComfyUI安装无误,则在最新版本的菜单界面中ComfyUI Manager位置如上图
2.ComfyUI Manager旧版本菜单入口位置
如果安装成功了,打开ComfyUI的界面后你应该可以看到下面这张图片的效果(旧版本)
在菜单的选项中会新增一个Manager的选项,这就是ComfyUI Manager的入口
3.ComfyUI Manager安装插件
步骤一:在弹出的ComfyUI Manager Menu中,你可以看到有Custom Nodes Manager(安装新插件)的入口,点击对应按钮即可,如下图
在这个步骤这里,你也可以点击界面中的Install via Git URL按钮,然后输入对应的Git地址进行安装
步骤二:下图是对应的Custom Nodes Manager界面
- 在
1
处,在搜索框中输入你想要安装的插件名称,如ComfyUI-Manager - 在
2
处,找到你需要的插件,点击Install按钮进行安装 - 在
3
处,你也可以使用对应Git地址进行安装 - 等待安装完成,有时可能需要重启ComfyUI才能应用对应的安装
4.ComfyUI Manager更新插件
更新插件与安装插件相同,在对应的插件过滤(Filter)筛选出已安装的插件,然后点击Try Update按钮进行更新
二、使用Git安装ComfyUI插件
这里我介绍两种安装方法
- Git命令行安装(需要预先安装Git推荐使用)
- Github Desktop安装(对于不熟悉Git的相对使用起来比较友好)
非常建议你了解并初步学习一下Git,具体你可以查看Git安装及入门指南部分
1. Git命令行安装ComfyUI插件
如何找到对应插件的Git地址
- git软件下载:https://git-scm.com/
首先找到你要安装的插件的Git仓库,如https://github.com/ltdrdata/ComfyUI-Manager
- 点击页面中绿色的**<>code**按钮
- 点击弹窗的https选项下输入框后的复制按钮
- 你将复制得到https://github.com/ltdrdata/ComfyUI-Manager.git的链接
如何使用Git命令行安装插件
- 打开你的CMD终端,首先使用
cd
命令进入你ComfyUI插件所在文件夹,如E:/ComfyUI_windows_portable/ComfyUI/custom_nodes
cd E:/ComfyUI_windows_portable/ComfyUI/custom_nodes
- 然后使用
git clone
命令克隆对应的代码仓库
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
- 等待成功提示
- 重启ComfyUI,查看插件是否安装完成
注:中国国内环境使用Github容易导致失败,你可以先将对应插件仓库同步到Gitee等国内代码仓库,增大成功率
如何使用Git更新对应插件?
使用Git更新对应插件,和之前的步骤一样,你需要使用
cd
先进入对应的插件目录,然后使用
git pull
命令进行更新
# 进入插件目录
cd E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager
# 使用git pull命令更新
git pull
2. Github Desktop安装与更新插件
使用Github Desktop其实不是一个很推荐的方式,其实Git的掌握也不会很复杂,
- 首先你需要先在github上注册一个账号,GitHub注册地址:https://github.com/
- 然后你需要先下载Github Desktop,下载地址:https://desktop.github.com/
- 下载并安装完成以后,打开软件并完成对应的账号登录
使用Github Desktop安装插件
使用Github Desktop安装插件步骤如下:
- 点击
File
菜单,选择
Clone repository
选项 - 在弹出的窗口中选择最后项URL的Clone的方式
- 选择你要安装的插件的目录,一般是你的ComfyUI安装目录下的
custom_nodes
目录,在我提供的截图里我先设置了
D:\ComfyUI_windows_portable\ComfyUI\custom_nodes
目录,这个是我的ComfyUI安装目录
你可以看到页面会有一个提示”This folder contains files.Git Can only clone empty folders”,这个是提示你这个目录下有文件,Git只能克隆内容到空目录里,这个不用担心,当我们输入插件的Github仓库地址以后目录会更新这个提示也会消失的
- 在URL输入框中输入你要安装的插件的Git仓库地址,如https://github.com/kijai/ComfyUI-Hunyuan3DWrapper,你会注意到对应的安装目录随着我们的输入的地址也会更新
- 点击
Clone
按钮,等待安装完成
重启ComfyUI,等待界面完成必要的依赖安装,这样你就完成了对应插件的安装
使用Github Desktop更新插件
从上面的截图里你可以看到,我使用Github Desktop安装了几个不同作者的git仓库
- 点击我标了序号1的位置,会打开使用Github Desktop安装的git仓库的地址
- 如果对应的插件有更新,你可以看到一个类似序号2处的箭头提示
- 点击对应的菜单,切换到对应的仓库,然后界面里你一般可以看见和序号3处一样的更新提示,点击
Pull Origin
按钮,就可以完成插件的更新
三、手动安装:压缩包手动安装ComfyUI插件插件
首先访问对应仓库地址:https://github.com/ltdrdata/ComfyUI-Manager
💡
通常我不太推荐使用手动安装的方式,因为这个过程中可能会丢失Git仓库的信息,然而很多插件都会有较为频繁的更新,使用手动安装的更新可能没有办法向使用Git安装那样方便更新
- 通常对应的仓库有提供对应的Readme安装说明,你可以参照安装说明进行安装
- 点击页面中绿色的**<>code**按钮
- 点击弹窗的Download ZIP按钮
- 下载完成后解压压缩包
- 将解压后的文件夹复制到
comfyui/custom_nodes
的插件目录下 - 重启ComfyUI,查看插件是否安装完成
使用这种方式如果要更新对应的插件,只能重复安装方式再进行一遍手动安装
四、秋叶启动器安装插件
- 确保ComfyUI没有在运行,
- 在秋叶启动器中选择
版本管理\安装扩展
(下图使用的是英文版本界面) - 搜索或浏览找到你想要安装的插件,点击安装即可
- 如果没有,你可以可以通过这个界面的
Extension URL
将对应的插件Git地址安装到此处,就可以使用Git来安装了(和Git安装类似)
如何使用秋叶启动器更新插件
同样还是在版本管理\安装扩展界面,你可以点击刷新,让软件检测对应的Git仓库有没有更新,如果有更新手动更新或者切换版本即可
五、中国境内使用Gitee克隆Github插件仓库
如果你在中国境内,很可能会因为Github访问问题导致安装失败,这时候你可以使用Gitee来克隆对应的Github仓库,然后获取到克隆后的你的仓库地址,然后使用这个地址来通过以上的方式来安装。
不过这种方式的缺点也非常明显,由于它是转存了Github仓库,所以你无法获取到上游Github仓库的最新更新,每次需要更新插件的时候你都需要通过Gitee来获取到上游的更新,然后再检测更新
首先你需要先在gitee上注册一个账号,Gitee注册地址:https://gitee.com/
- 注册完成后,点击
+新建
按钮,选择新建仓库 - 新建仓库页面选择
点击导入
选项 - 在导入仓库页面,选择从URL导入
并填写对应的仓库地址链接如:
- https://github.com/ltdrdata/ComfyUI-Manager.git
- https://github.com/ltdrdata/ComfyUI-Manager
这两种格式都可以被接受
- 填写完成后点击导入
导入完成之后对应的仓库就会被克隆到你的账号之下后期如果你想要更新插件代码,请记得只有你先更新你克隆的仓库,然后你才能获取到上游的更新 - 序号5处的按钮是用来更新同步上游仓库代码的
- 点击克隆/下载按钮,你就可以获取到对应的仓库地址
在节点完成安装完成后,为了保证对应节点的功能能够正常使用,还需要安装对应的依赖,下面我将正对不同版本的ComfyUI的依赖安装进行一个补充,然后针对特殊地区比如中国境内,在使用对应依赖安装命令时候,需要使用中国国内的镜像地址来进行安装
六、ComfyUI自定义节点依赖的安装
这个部分是针对不同版本的ComfyUI的依赖安装进行一个补充,针对你使用的ComfyUI版本和安装方式,你可以选择对应的依赖安装方式。
💡
如果不同的节点依赖了同一个包的不同版本,则有可能会出现依赖冲突的问题。
ComfyUI便携版(Portable)版本
便携版(Portable)版本,使用的是嵌入式Python版本,所以需要使用嵌入式Python来安装对应的依赖,需要在使用命令行进入portable的插件目录
cd E:/ComfyUI_windows_portable/
然后使用嵌入式Python来安装对应的依赖
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
Python虚拟环境
如果你自己创建了ComfyUI的Python虚拟环境,那么你需要进入对应的插件文件夹,比如在本文中,我们安装了ComfyUI-Manager插件,所以我们要找到对应插件依赖文件的目录
E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager/requirements.txt
然后我们使用
pip
命令来安装对应的依赖
pip install -r E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager/requirements.txt
使用中国国内镜像源
对于中国大陆用户,由于网络限制,在安装依赖时可能会遇到问题。可以使用国内镜像源加速下载。只需在使用pip命令时添加
-i
参数指定镜像源:
# 使用清华大学镜像
pip install -r E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 便携版本使用方法
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
常用的国内镜像源包括:
1.8 GPU购买参考3. 安装模型