ComfyUI-Step1X-Edit

ComfyUI Custom Node for Step1X-Edit. Noted this node may consume large VRAMs!

Installation

1. Navigate to your ComfyUI's custom_nodes directory:

cd ComfyUI/custom_nodes

2. Clone this repository:

git clone https://github.com/Quank123WIP/ComfyUI-Step1X-Edit

3. Install requirements:

cd ComfyUI-Step1X-Edit
pip install -r requirements.txt

Please noted this project requires flash attention, but build it using pip consumes lots of time. Try to build it manually or use prebuilt wheel according to original guideline. If you have problem building it, I suggest you to install torch<=2.6 and use the prebuilt wheel.

Or Install via ComfyUI Manager

Usage

Download the safetensors weight of the pretrained model from here, and then place them in models/Step1x-Edit (both the vae and model itself).

Download the vision encoder(Qwen/Qwen2.5-VL-7B-Instruct) weight from here, and place the whole folder inside models/MLLM.

Citation

@article{liu2025step1x-edit,
      title={Step1X-Edit: A Practical Framework for General Image Editing}, 
      author={Shiyu Liu and Yucheng Han and Peng Xing and Fukun Yin and Rui Wang and Wei Cheng and Jiaqi Liao and Yingming Wang and Honghao Fu and Chunrui Han and Guopeng Li and Yuang Peng and Quan Sun and Jingwei Wu and Yan Cai and Zheng Ge and Ranchen Ming and Lei Xia and Xianfang Zeng and Yibo Zhu and Binxing Jiao and Xiangyu Zhang and Gang Yu and Daxin Jiang},
      journal={arXiv preprint arXiv:2504.17761},
      year={2025}
}

Disclaimer

The results produced by this image editing model are entirely determined by user input and actions. The development team and this open-source project are not responsible for any outcomes or consequences arising from its use.

License

MIT License