README.md

September 20, 2025 ยท View on GitHub

ComfyMind: Toward General-Purpose Generation

via Tree-Based Planning and Reactive Feedback

Project Page arXiv Paper Demo

๐Ÿ’ซ Introduction

Teaser

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

  1. 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
  1. Install dependencies:
pip install -r requirements.txt

โš ๏ธ 3. Before using ComfyMind, please prepare your ComfyUI with necessary models and extensions.

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.