README.md

---
license: other
license_name: ubisoft-machine-learning-license-research-only-copyleft
license_link: LICENSE
datasets:
- gvecchio/MatSynth
---

<div align="center">
<h1>Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images</h1>

<a href="https://arxiv.org/abs/2509.09952"><img src="https://img.shields.io/badge/arXiv-2509.09952-B31B1B?logo=arxiv&logoColor=white&style=flat-square" alt="arXiv"></a>
<a href="https://ubisoft-laforge.github.io/world/chord/"><img src="https://img.shields.io/badge/Project-Page-brightgreen?logo=ubisoft&logoColor=white&style=flat-square" alt="Project Page"></a>
<a href="https://huggingface.co/spaces/ksangk/chord-demo"><img src="https://img.shields.io/badge/🤗%20HuggingFace-Demo-blue.svg?style=flat-square" alt="Demo"></a>

[Zhi Ying](https://orcid.org/0009-0008-8390-3366)\*, [Boxiang Rong](https://ribosome-rbx.github.io/)\*, [Jingyu Wang](https://ccetaw.github.io/), [Maoyuan Xu](https://ultraman-blazar.github.io/)

<img src="teaser.jpg" alt="teaser">
</div>

Official implementation of the paper "**Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images**".

## Setup environment

1. Clone github repo:

    ```shell
    git clone https://github.com/ubisoft/ubisoft-laforge-chord
    cd ubisoft-laforge-chord
    ```

3. Install dependencies. The example below uses [uv](https://docs.astral.sh/uv/getting-started/) to manage the virtual environment:

    ```shell
    # Get Python environment
    uv venv --python 3.12

    # On Linux/WSL
    source .venv/bin/activate

    # Or on Windows
    .venv\Scripts\activate

    # If you encounter the following error on Windows:
    # File .venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system
    # Run the command: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

    # Install dependencies
    uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128
    uv pip install -r requirements.txt
    ```

4. Agree to the model's term from [here](https://huggingface.co/Ubisoft/ubisoft-laforge-chord), then log in:

    ```
    huggingface-cli login
    ```

5. (Optional) Install Gradio for running demo locally:

    ```
    uv pip install gradio
    ```

## Usage example

Run test:

```shell
python test.py --input-dir examples
```

Run the Gradio demo locally:

```shell
python demo_gradio.py
```

## License

This project is released under the **Ubisoft Machine Learning License (Research-Only - Copyleft)**. See the full terms in the [LICENSE](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.