ComfyUI-Copilot

环境要求

• 已安装并可正常运行 ComfyUI
• 系统具备 git 与 pip（Python 包管理）
• ComfyUI 目录下存在 custom_nodes 自定义节点目录
• 能够访问 GitHub 克隆仓库

安装与启动步骤

1. 1进入自定义节点目录

   打开终端，切换到 ComfyUI 安装目录下的 custom_nodes 文件夹，后续插件都装在这里。

   cd ComfyUI/custom_nodes

   复制

2. 2克隆 Copilot 仓库

   在 custom_nodes 目录下克隆 ComfyUI-Copilot 源码，README 提供 SSH 与 HTTPS 两种地址，任选其一。

   git clone https://github.com/AIDC-AI/ComfyUI-Copilot

   复制

3. 3安装 Python 依赖

   进入克隆下来的项目目录，用 pip 按 requirements.txt 安装依赖，网络慢时可换国内镜像源。

   cd ComfyUI/custom_nodes/ComfyUI-Copilot
   pip install -r requirements.txt

   复制

4. 4Windows 用户装依赖

   Windows 便携版可用自带 Python 执行依赖安装，路径按实际 ComfyUI 安装位置调整。

   python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Copilot\requirements.txt

   复制

5. 5填写 API Key

   启动 ComfyUI 后进入设置页，填入自己的 API Key 和 Base URL，才能使用 Agent 相关能力。

6. 6或用 Manager 安装

   也可在 ComfyUI Manager 的 Custom Nodes Manager 搜索 ComfyUI-Copilot 安装，并更新到最新版。

   sudo python main.py

   复制

关键配置

如何确认成功

重启 ComfyUI 后界面出现 Copilot 面板，且设置页能保存 API Key 与 Base URL，即安装成功。

常见问题

注意事项

• README 明确表示 Manager 安装方式容易出 bug，推荐使用 git 安装方式。
• 使用 Manager 时建议以 sudo python main.py 启动 ComfyUI，避免权限导致的执行错误。
• 官方 API 服务已暂停，必须自行准备 API Key 与 Base URL 才能使用 Agent 能力。
• 安装完成后建议更新 ComfyUI-Copilot 到最新版本。