README.md
September 20, 2025 ยท View on GitHub
ComfyMind: Toward General-Purpose Generation
via Tree-Based Planning and Reactive Feedback
๐ซ Introduction

We present ComfyMind, a collaborative AI system designed to enable robust and scalable general-purpose generation, built on the ComfyUI platform. We evaluate ComfyMind on three public benchmarks: ComfyBench, GenEval, and Reason-Edit, which span generation, editing, and reasoning tasks. Results show that ComfyMind consistently outperforms existing open-source baselines and achieves performance comparable to GPT-Image-1. ComfyMind paves a promising path for the development of open-source general-purpose generative AI systems.
๐ฐ News
- [2025/09/20] We have released the evaluation code and the results of ComfyMind on evaluation benchmarks.
- [2025/09/19] ComfyMind has been accepted by NeurIPS 2025 ๐๐๐
- [2025/05/30] Our online demo has been released. https://envision-research.hkust-gz.edu.cn/ComfyMind/
- [2025/05/24] Our paper is submitted to arXiv.
๏ธโ๏ธ Installation
Step-by-step Installation
- Clone the repository, create and activate conda environment:
git clone https://github.com/LitaoGuo/ComfyMind.git
cd ComfyMind
conda create -n comfymind python=3.12
conda activate comfymind
- Install dependencies:
pip install -r requirements.txt
โ ๏ธ 3. Before using ComfyMind, please prepare your ComfyUI with necessary models and extensions.
- ComfyUI Installation
- ComfyUI-Manager offers custom nodes management and installation.
- Hugging Face offers Models Installation
Configuration
โ ๏ธ Modify config.yaml to set your APIs:
๐ Usage
Execute the main script
python main.py \
--instruction "The generation instruction" \
--resource1 "<optional>path/to/the/reference1" \
--resource2 "<optional>path/to/the/reference2"
--save_path "path/to/save/result"
Gradio Demo
python main_gradio.py
Evaluation
The results of ComfyMind on evaluation benchmarks can be viewed via https://drive.google.com/drive/folders/1pR5vCQoo-W0Tr3vodyfQEWrI3om15Dak?usp=drive_link.
To run the evaluation for ComfyMind, you can execute the following commands:
python Evaluation/eval_geneval.py ,
python Evaluation/eval_reason_edit.py
๐ Citation
If you find our work helpful, please consider citing our paper:
@article{guo2025comfymind,
title={ComfyMind: Toward General-Purpose Generation via Tree-Based Planning and Reactive Feedback},
author={Guo, Litao and Xu, Xinli and Wang, Luozhou and Lin, Jiantao and Zhou, Jinsong and Zhang, Zixin and Su, Bolan and Chen, Ying-Cong},
journal={arXiv preprint arXiv:2505.17908},
year={2025}
}
โค๏ธ Acknowledgments
We would like to thank the authors of the following projects for their excellent works.
๐ License
This code is released under the MIT License.
๐ Contact
If you have any questions, please raise an issue or contact us at guolitauo@gmail.com.