ICEdit
[NeurIPS 2025] Image editing is worth a single LoRA! 0.1% training data for fantastic image editing! Surpasses GPT-4o in ID persistence~ MoE ckpt released! Only 4GB VRAM is enough to run!
Install / Use
/learn @River-Zhang/ICEditREADME
:open_book: For more visual results, go checkout our <a href="https://river-zhang.github.io/ICEdit-gh-pages/" target="_blank">project page</a>
<div align="left">🎆 News
- [2025/9/19] 🔥 We have open-sourced our MoE version ICEdit and ckpt. Have a try!🚀
- [2025/9/18] 🌟 ICEdit has been accepted by NeurIPS 2025!🎉 See you in San Diego!
- [2025/8/21] 🌟 We have released an Ascend (Huawei NPU)-powered version of ICEdit. Now you can run ICEdit on Ascend NPU! Many thanks to Zhiyuan!
- [2025/5/16] 🌟 Many thanks to gluttony-10 (十字鱼) for adapting Gradio demo with GGUF quantization, further reducing memory usage to 10GB.
- [2025/5/14] 🔥 With the help of the official comfy-org, we have integrated our ComfyUI nodes into Comfy Registry!
- [2025/5/13] 🔥 We have released the training code! Train your own editing LoRAs now!
- [2025/5/11] 🌟 Great thanks to gluttony-10 (十字鱼) for making a windows gradio demo to use our project on Windows!
- [2025/5/8] 🔥 We have released our official ComfyUI workflow! 🚀 Check the repository and have a try!
- [2025/5/8] 🔥 We have added LoRA scale slider in the gradio demo. You can try to discover more interesting demo with different scale!
- [2025/5/7] 🌟 We update some notes when using the ComfyUI workflow to avoid unsatisfactory results!
- [2025/5/6] 🔥 ICEdit currently ranks 2nd on the overall/weekly trending list of Hugging Face space. Thank you all for your support and love!🤗
- [2025/5/5] 🌟 Heartfelt thanks to Datou for creating a fantastic ComfyUI workflow on OpenArt! 🚀 Have a try!
- [2025/5/2] 🌟 Heartfelt thanks to judian17 for crafting an amazing ComfyUI-nunchaku demo! Only 4GB VRAM GPU is enough to run with ComfyUI-nunchaku!🚀 Dive in and give it a spin!
- [2025/4/30] 🔥 We release the Huggingface Demo 🤗! Have a try!
- [2025/4/30] 🔥 We release the paper on arXiv!
- [2025/4/29] We release the project page and demo video! Codes will be made available in next week~ Happy Labor Day!
🎈 Tutorial on Bilibili or Youtube
👑 Feel free to share your results in this Gallery!
- [2025/5/15] 🌟 We find that 啦啦啦的小黄瓜 has made a detailed bilibili tutorial introducing our model! What a great video!
- [2025/5/14] 🌟 We find that Nenly同学 has made a fantastic bilibili tutorial on how to use our repository! Great thanks to him!
- [2025/5/10] 🌟 Great thanks to 月下Hugo for making a Chinese tutorial on how to use our official workflow!
- [2025/5/7] 🌟 Heartfelt thanks to T8star for making a tutorial and ComfyUI workflow on how to increase the editing success to 100%!🚀 Have a try!
- [2025/5/3] 🌟 Heartfelt thanks to softicelee2 for making a Youtube video on how to use our model!
📖 Table of Contents
- 🎆 News
- 🎈 Tutorial on Bilibili or Youtube
- 📖 Table of Contents
- 💼 Installation
- 🔧 Training
- 🎨ComfyUI Workflow
- ⚠️ Tips
- 💪 To Do List
- 💪 Comparison with Commercial Models
- 🌟 Star History
- Bibtex
📢 Attention All: Incorrect ComfyUI Workflow Usage Alert!
-
We have released our official ComfyUI workflow for proper usage! Check our repository and have a try!
- You need to add the fixed pre-prompt "A diptych with two side-by-side images of the same scene. On the right, the scene is exactly the same as on the left but {instruction}" before inputing the edit instructions, otherwise you may get bad results! (This is mentioned in the paper!, The code for the Hugging Face gradio demo already embeds this prompt. So, you can simply input the editing instructions without additional setup.)
- The width of the input image must resize to 512 (no restriction to height).
- Please use the Normal LoRA not the MoE-LoRA, because the MoE-LoRA cannot be correctly loaded with ComfyUI lora loader.
- 🔥💐🎆 Welcome to share your creative workflows (such as combining Redux, ACE, etc.) in the Issues section and showcase the results! We will include references so that more people can see your creativity.
💼 Installation
Conda environment setup
conda create -n icedit python=3.10
conda activate icedit
pip install -r requirements.txt
pip install -U huggingface_hub
Download pretrained weights
If you can connect to Huggingface, you don't need to download the weights. Otherwise, you need to download the weights to local.
~~Note: Due to some cooperation permission issues, we have to withdraw the weights and codes of moe-lora temporarily. What is released currently is just the ordinary lora, but it still has powerful performance. If you urgently need the moe lora weights of the original text, please
Related Skills
node-connect
344.4kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
99.2kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
344.4kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
344.4kQQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
