🎯 ComfyUI-Copilot: ComfyUI 智能助手

👾 阿里巴巴国际数字商业集团 👾

https://github.com/user-attachments/assets/17f8e822-e852-47fc-8dcb-0471526b099e

🌟 介绍

ComfyUI-Copilot 是基于 ComfyUI 框架构建的 AIGC 智能助手，致力于为文本、图像、音频等多模态内容生成提供智能支持：无论是节点推荐、工作流构建辅助、模型查询，还是参数自动优化，ComfyUI-Copilot 都能简化 AI 算法的调试与部署流程，让创作更高效、更轻松。

🎉 2025.08.14 重磅更新：全面升级为工作流开发助手

本次发布的 ComfyUI-Copilot v2.0 版本从“辅助工具”升级为“开发伙伴” —— 不再只是协助你开发工作流，而是能够自主完成开发任务。我们覆盖了工作流的生成、调试、改写与调参等全链路环节，旨在带来更高效的创作体验。核心新功能包括：

🔧 一键 Debug：自动检测工作流中的错误，精准定位问题并提供修复建议。
🔄 工作流改写：根据您的描述，优化当前工作流结构，修改参数、新增节点。
🚀 工作流生成能力升级：更精准地理解您的需求，生成符合要求的工作流，降低搭建门槛。
🧠 智能体架构升级：可感知您的本地ComfyUI环境，输出最优解决方案，实现个性化适配。

✨ 立即体验全新 ComfyUI-Copilot v2.0，开启更智能的创作之旅！

🔥 核心功能（V2.0.0）

1. 💎 生成第一版工作流：根据您的文字描述，提供符合您需求的工作流，返回3个知识库里的优质工作流和1个AI生成的工作流，您可以一键导入到ComfyUI中，开始生图。
- 直接在输入框输入：我想要一个xxx的工作流。
1. 💎 工作流Debug：自动分析工作流中的错误，帮您修复参数错误和工作流连接错误，并给出优化建议。
- 上方返回的4个工作流里，当您选中了一个点击Accept后，会导入ComfyUI的画布中。此时您可以点击Debug按钮，开始调整错误。
- 输入框右上角有一个Debug按钮，点击后直接对当前的画布上的工作流进行Debug。
- 如果识别出来工作流缺失了模型，会自动提示您下载模型。

- 您也可以直接点击下方的模型下载按钮，输入模型关键词，从推荐的模型里选择所需模型。

1. 💎 之前的工作流生图效果不满意？：提出您不满意的地方，让我们帮您修改工作流，增加节点，修改参数，优化工作流结构。
- 在输入框输入：帮我在当前的画布上添加一个xxxx。
- 注意事项：如果是2025年5月往后新出的模型，例如wan2.2等模型，可能会导致LLM无法理解，进程中断。可以尝试添加专家经验，来帮助LLM更好的生成工作流。
- 工作流改写难度高，且会携带大量上下文，需要控制上下文长度，否则容易中断，建议经常点击右上角的清空上下文按钮，控制对话长度。
1. 💎 调参过程太痛苦？：我们为您提供了调参工具，您可以设置参数范围，系统会自动批量执行不同参数组合，并生成结果可视化对比，帮助您快速找到最优参数配置。
- 切换Tab到GenLab，然后根据引导使用，请注意此时的工作流要能正常运行，才能批量跑图评估参数。

想让ComfyUI-Copilot辅助您完成工作流开发？

1. 💎 节点推荐：根据您的描述，推荐您可能需要的节点，并给出推荐理由。
- 在输入框输入：我想要一个能完成xxx的节点。
1. 💎 节点查询系统：选中画布上的节点，点击节点查询按钮，深入探索节点，查看其说明、参数定义、使用技巧和下游工作流推荐。
- 在输入框输入：xxx节点的用处、输入和输出。
1. 💎 模型推荐：根据您的需求，为您查找基础模型和 'lora'。
- 在输入框输入：我想要一个生成xxx图片的Lora。
1. 💎 下游节点推荐：在您选中了画布上的某个节点后，根据您画布上已有的节点，推荐您可能需要的下游子图。

🚀 快速开始

仓库概览：访问 GitHub 仓库以获取完整代码库。

安装

首先，用git把ComfyUI-Copilot安装到ComfyUI的custom_nodes目录下：

cd ComfyUI/custom_nodes
git clone git@github.com:AIDC-AI/ComfyUI-Copilot.git

或

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

然后，在ComfyUI的custom_nodes目录下，找到ComfyUI-Copilot目录，安装ComfyUI-Copilot的依赖

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

如果您是windows用户：

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

使用 ComfyUI 管理器：打开 ComfyUI 管理器，点击自定义节点管理器，搜索 ComfyUI-Copilot，并点击安装按钮。注意：请点击update按钮更新到最新版本的ComfyUI-Copilot。
- Manager需要权限，为了防止执行的过程中报错，建议运行的时候使用 sudo python main.py。
- 如果你遇到update的时候报错，此时需要你删掉这个文件夹或者点击uninstall，再重新install一次。
- 如果执行报错，建议打开右上角的底部面板按钮，触发Manager安装ComfyUI-Copilot，此时下方会出现报错日志，截图并贴到git issue里，我们会尽快跟进。
- 使用Manager安装容易遇到bug，建议使用上方的git安装方式