ComfyUI-Chord

ComfyUI custom node for the paper: Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images

Installation

1. Download and install ComfyUI. If you are new to ComfyUI, refer to the original repository to get started. Make sure you have the latest version.

2. Download the pretrained model chord_v1.safetensors from Hugging Face and place it in the folder ./ComfyUI/models/checkpoints.

3. Install the custom nodes by manually cloning this repository in the custom nodes folder, with the argument --recursive:

Note the ComfyUI-Manager does not support cloning with --recursive dependencies. The nodes have to be cloned manually for the moment.

# Clone the repository
cd ./ComfyUI/custom_nodes
git clone --recursive https://github.com/ubisoft/ComfyUI-Chord.git

# Install dependencies
## For Python version
pip install -r .\ComfyUI-Chord\requirements.txt

## Or for Windows portable version
..\..\python_embeded\python.exe -s -m pip install -r .\ComfyUI-Chord\requirements.txt

4. When running the nodes for the first time, they will download the model Stable Diffusion 2.1 from this repository on the Hugging Face hub: RedbeardNZ/stable-diffusion-2-1-base. The download will be placed in the Hugging Face cache folder C:\Users\[your-username]\.cache\huggingface\hub\models--RedbeardNZ--stable-diffusion-2-1-base. We are working on simplifying this dependency to have all models centralized in the ComfyUI models folder.

Example Workflow

You can load this workflow using the JSON file example_workflows/chord_image_to_material.json or by dropping the image in ComfyUI.

License

This project is released under the Ubisoft Machine Learning License (Research-Only - Copyleft). See the full terms in the LICENSE file.

Citation

If you find our work useful, please consider citing:

@inproceedings{ying2025chord,
    author = {Ying, Zhi and Rong, Boxiang and Wang, Jingyu and Xu, Maoyuan},
    title = {Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images},
    year = {2025},
    isbn = {9798400721373},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {https://doi.org/10.1145/3757377.3763848},
    doi = {10.1145/3757377.3763848},
    booktitle = {Proceedings of the SIGGRAPH Asia 2025 Conference Papers},
    articleno = {164},
    numpages = {11},
    keywords = {Appearance Modeling, Material Generation, Texture Synthesis, SVBRDF, Image-conditional Diffusion Models},
    series = {SA Conference Papers '25}
}

© [2025] Ubisoft Entertainment. All Rights Reserved.