+3
日增长
5,585
stars
373
forks
62
watchers
51
prs
100
issues
3
releases
README
中文 | English
🎯 ComfyUI-Copilot: ComfyUI 智能助手
👾 _阿里巴巴国际数字商业集团_ 👾
https://github.com/user-attachments/assets/17f8e822-e852-47fc-8dcb-0471526b099e
⚠️ 服务更新与调整公告
温馨提示: 由于内部服务审查与升级,以下功能即将停止提供:
- 节点信息查询
- 工作推荐
- 工作流生成
API 服务已暂停提供。 如需继续使用 Agent 相关能力,请前往设置页面填写您自己的 API Key 和 Base URL。
所有 Agent 相关能力不受本次调整影响,仍可正常使用。对于由此带来的不便,我们深表歉意,感谢您的理解与支持。
---
🌟 介绍
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的工作流。
- 2. 💎 工作流Debug:自动分析工作流中的错误,帮您修复参数错误和工作流连接错误,并给出优化建议。
- 上方返回的4个工作流里,当您选中了一个点击Accept后,会导入ComfyUI的画布中。此时您可以点击Debug按钮,开始调整错误。
- 输入框右上角有一个Debug按钮,点击后直接对当前的画布上的工作流进行Debug。
- 如果识别出来工作流缺失了模型,会自动提示您下载模型。
- 您也可以直接点击下方的模型下载按钮,输入模型关键词,从推荐的模型里选择所需模型。
- 3. 💎 之前的工作流生图效果不满意?:提出您不满意的地方,让我们帮您修改工作流,增加节点,修改参数,优化工作流结构。
- 在输入框输入:帮我在当前的画布上添加一个xxxx。
- 注意事项:如果是2025年5月往后新出的模型,例如wan2.2等模型,可能会导致LLM无法理解,进程中断。可以尝试添加专家经验,来帮助LLM更好的生成工作流。
- 工作流改写难度高,且会携带大量上下文,需要控制上下文长度,否则容易中断,建议经常点击右上角的清空上下文按钮,控制对话长度。
- 4. 💎 调参过程太痛苦?:我们为您提供了调参工具,您可以设置参数范围,系统会自动批量执行不同参数组合,并生成结果可视化对比,帮助您快速找到最优参数配置。
- 切换Tab到GenLab,然后根据引导使用,请注意此时的工作流要能正常运行,才能批量跑图评估参数。
想让ComfyUI-Copilot辅助您完成工作流开发?
- 5. 💎 节点推荐:根据您的描述,推荐您可能需要的节点,并给出推荐理由。
- 在输入框输入:我想要一个能完成xxx的节点。
- 6. 💎 节点查询系统:选中画布上的节点,点击节点查询按钮,深入探索节点,查看其说明、参数定义、使用技巧和下游工作流推荐。
- 在输入框输入:xxx节点的用处、输入和输出。
- 7. 💎 模型推荐:根据您的需求,为您查找基础模型和 'lora'。
- 在输入框输入:我想要一个生成xxx图片的Lora。
!模型推荐1
- 8. 💎 下游节点推荐:在您选中了画布上的某个节点后,根据您画布上已有的节点,推荐您可能需要的下游子图。
---
🚀 快速开始
仓库概览:访问 GitHub 仓库 以获取完整代码库。
安装
1. 首先,用git把ComfyUI-Copilot安装到ComfyUI的custom_nodes目录下:
bash
cd ComfyUI/custom_nodes
git clone [email protected]:AIDC-AI/ComfyUI-Copilot.git
或
bash
cd ComfyUI/custom_nodes
git clone https://github.com/AIDC-AI/ComfyUI-Copilot
然后,在ComfyUI的custom_nodes目录下,找到ComfyUI-Copilot目录,安装ComfyUI-Copilot的依赖
bash
cd ComfyUI/custom_nodes/ComfyUI-Copilot
pip install -r requirements.txt
如果您是windows用户:
bash
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Copilot\requirements.txt
2. 使用 ComfyUI 管理器:打开 ComfyUI 管理器,点击自定义节点管理器,搜索 ComfyUI-Copilot,并点击安装按钮。注意:请点击update按钮更新到最新版本的ComfyUI-Copilot。
- Manager需要权限,为了防止执行的过程中报错,建议运行的时候使用 sudo python main.py。
- 如果你遇到update的时候报错,此时需要你删掉这个文件夹或者点击uninstall,再重新install一次。
- 如果执行报错,建议打开右上角的底部面板按钮,触发Manager安装ComfyUI-Copilot,此时下方会出现报错日志,截图并贴到git issue里,我们会尽快跟进。
- Top issues
#8对话显示Failed to fetch是什么原因11 comments · 2025-02-22#105Chat no responses.7 comments · 2025-10-21#100新版本的好像无法联网,不起作用。7 comments · 2025-10-04#9安装成功,但是右上角没有图标显示6 comments · 2025-02-24#83IMPORT FAILED5 comments · 2025-08-19#57Please add local Ai model support (no internet connection required)5 comments · 2025-04-21#106Install fail4 comments · 2025-10-29#86为什么点开以后对话框消失不见了4 comments · 2025-08-22
Discussions
#154Atlas Cloud Open Source Sponsorship — free credits for active OSS projects0 comments · 2026-07-08#142ComfyUI-Copilot has a page on Shypd (AI Tool Directory)0 comments · 2026-04-02#121如何使用专家模式0 comments · 2025-12-19#107Is it currently functional offline with local llm or not?0 comments · 2025-11-05#99Welcome to ComfyUI-Copilot Discussions!1 comments · 2025-09-24
Latest release
v2.0 v2.0 2025-08-18🎉 Major Update on 2025.08.14:Evolving into a Workflow Development Coworker The newly released ComfyUI-Copilot v2.0 evolves from a "helper tool" into a "development partner"—not just assisting with workflow development, but capable of autonomously completing development tasks. We now cover the entire workflow lifecycle, including generation, debugging, rewriting, and parameter tuning, aiming to deliver a significantly enhanced creative experience. Key new features include: - 🔧 One-Click Debug::Automatically detects errors in your workflow, precisely identifies issues, and provides repair