插件安装指南

ComfyUI插件可以扩展和增强ComfyUI的功能,使其支持更多模型、节点、界面功能、图像处理工具等。ComfyUI本身是一个高度模块化的节点式界面,通过插件可以轻松添加新功能,而不需要修改核心代码。

本指南将详细介绍两种安装ComfyUI插件的方法:

1.通过git clone安装(推荐)

2.通过ComfyUI Manager安装

方法一:通过git clone安装(推荐)

该方法适合熟悉命令行操作的用户,允许直接在ComfyUI服务端实例中部署插件。要求系统已安装Git工具(推荐版本 2.30+)和Python环境。

  1. 获取插件仓库地址

    访问目标插件的代码托管平台(如GitHub/GitLab),定位到项目的"Clone or download"按钮后选择HTTPS协议并复制完整URL。

    示例格式:https://github.com/nunchaku-tech/ComfyUI-nunchaku

    image

  2. 登录ComfyUI实例

    参考快速入门创建ComfyUI项目,创建完成后,单击项目开发 > 实例列表,并登录对应的实例进入终端页面。

    image

  3. 部署插件到ComfyUI

    # 进入插件安装目录
    cd comfyui/custom_nodes
    
    # 使用git命令克隆仓库插件
    git clone https://github.com/mit-han-lab/ComfyUI-nunchaku.git
  4. 安装依赖组件

    cd ComfyUI-nunchaku
    pip install -r requirements.txt --no-cache-dir
    说明

    建议添加--no-cache-dir参数避免缓存冲突。

  5. 重启ComfyUI服务

    单击Manager > Restart,重启ComfyUI应用程序,以便它能够加载并识别新的插件。

    image

    说明

    重启后需要刷新浏览器,如果服务未重启完成需要稍等一会再次刷新浏览器

  6. 更新插件(可选)

    如果您想更新通过git clone安装的插件,可以按照以下步骤操作:

    1. 登录ComfyUI实例进入终端页面。

    2. 使用cd命令进入您想要更新的插件的特定目录,例如:

      cd comfyui/ComfyUI-nunchaku
    3. 运行git pull命令来拉取最新的代码或者git checkout v-xxx切换到指定版本。

    4. 安装依赖 pip install -r requirements.txt

      说明

      某些插件可能包含自己的requirements.txt文件,安装这些依赖时可能会与其他已安装插件的依赖版本冲突 。如果遇到节点缺失或功能异常,请检查ComfyUI的控制台输出,并可能需要手动调整依赖。

    5. 重启ComfyUI使插件生效。

方法二:通过ComfyUI Manager安装

ComfyUI ManagerComfyUI官方推荐的插件管理工具,提供图形化界面实现自定义节点的浏览、安装与版本管理。相较于手动安装方式,Manager工具能自动处理依赖关系并验证插件兼容性,极大简化安装流程。

  1. 启动ComfyUI服务

    确保您的ComfyUI 实例正在运行,参考快速入门创建ComfyUI项目。

  2. 打开Manager界面

    ComfyUI界面的右侧面板上,单击Manager按钮,并在Manager 菜单栏中选择Custom Nodes Manager进入节点管理界面。

    image

  3. 搜索并安装插件

    在搜索框输入目标插件名称,或者直接在插件列表中选择想要的插件,单击对应行右侧的Install按钮。

    imageManager将自动执行以下操作:

    • 下载插件源代码。

    • 验证GPG签名(若插件支持)。

    • 安装Python依赖包。

    • 创建节点配置文件。

  4. 等待安装完成并重启ComfyUI

    安装完成后,单击Manager > Restart,重启ComfyUI应用程序,以便它能够加载并识别新的插件。

    image

    说明

    重启后需要刷新浏览器,如果服务未重启完成需要稍等一会再次刷新浏览器