ComfyUI-Copilot is an MIT-licensed TypeScript-based ComfyUI custom node that assists with workflow generation, debugging, and parameter tuning. It provides installation steps, usage features, and update notes, with latest release v2.0.0 as of 2025-08-14.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
ComfyUI-Copilot is an AIGC intelligent assistant built as a ComfyUI custom node to support workflow building, parameter optimization, and debugging tasks within ComfyUI.
How it works
The project offers features in v2.0.0 such as generating initial workflow versions from text descriptions, automatic workflow debugging, workflow rewriting to adjust parameters and structure, and parameter tuning tools. It includes node recommendations, node query capabilities, model recommendations, and downstream node suggestions. It operates within the ComfyUI environment and references a local Copilot activation and API/config workflow models.
Getting started
Installation steps:
- In the ComfyUI/custom_nodes directory, clone the repository:
cd ComfyUI/custom_nodes
git clone git@github.com:AIDC-AI/ComfyUI-Copilot.git
or
cd ComfyUI/custom_nodes
git clone https://github.com/AIDC-AI/ComfyUI-Copilot
- In the ComfyUI/custom_nodes/ComfyUI-Copilot directory, install dependencies:
dcd ComfyUI/custom_nodes/ComfyUI-Copilot
pip install -r requirements.txt
If Windows:
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Copilot\requirements.txt
Using ComfyUI Manager:
- Open ComfyUI Manager, Custom Nodes Manager, search for ComfyUI-Copilot, and install, updating to latest version.
- For errors, run ComfyUI with "sudo python main.py" or follow error log prompts in the Manager.
Note: The README includes several images and notes about updates and error handling.
Activation
After running the ComfyUI project, locate the Copilot activation button on the left side of the panel to launch its service.
API Key Generation
Click the button, enter your email to receive an API Key, paste it into the input box, and save to activate Copilot.
Config your model
Click the settings button to configure chat model and workflow generate model separately.
Note
The project is continuously updated; use git pull or the ComfyUI Manager to update to the latest code.
Recent releases
- v2.0 (2025-08-18): Major update introducing Workflow Development Coworker capabilities. Features include One-Click Debug, Workflow Rewriting, Enhanced Workflow Generation, and Upgraded Agent Architecture.
- v1.0.4 (2025-03-11): Release notes with New Features including SD Prompt Generation.
- v1.0.0 (2025-02-20): Initial release with User Intent Workflow Recall and Node Recommendation/Retrieval.
Traction
Stars: 5432 Forks: 357 Open issues: 52
Behind the repo
Organization: ATH-MaaS (repository owner), language: TypeScript, license: MIT, created: 2025-02-14, last_push: 2026-04-07. Topics include agent, ai, comfy-ui, copilot, gpt-4, llm-agent, rag, stable-diffusion.
Caveats
License: MIT Age: Created 2025-02-14 Open issues: 52 Last push: 2026-04-07