Refacade / README.md
fishze's picture
Update README.md
78dbef8 verified
metadata
license: apache-2.0
pipeline_tag: video-to-video
library_name: diffusers

Refaรงade: Editing Object with Given Reference Texture

Youze Huang1,* Penghui Ruan2,* Bojia Zi3,* Xianbiao Qi4,โ€  Jianan Wang5 Rong Xiao4
* Equal contribution. โ€  Corresponding author.

Huggingface Model Github arXiv Huggingface Space Demo Page

๐Ÿš€ Overview

Refaรงade is a unified imageโ€“video retexturing model built upon the Wan2.1-based VACE framework. It edits the surface material of specified objects in a video using user-provided reference textures, while preserving the original geometry and background. We use Jigsaw Permutation to decouple structural information in the reference image and a Texture Remover to disentangle the original objectโ€™s appearance. This functionality enables users to explore diverse possibilities effectively.


๐Ÿ› ๏ธ Installation

Our project is built upon Wan2.1-based VACE.

pip install -r requirements.txt
pip install wan@git+https://github.com/Wan-Video/Wan2.1

๐Ÿƒโ€โ™‚๏ธ Gradio Demo

You can use this gradio demo to retexture objects. Note that you don't need to compile the SAM2.

python app.py

๐Ÿ“‚ Download

First, download our checkpoints:

huggingface-cli download --resume-download fishze/Refacade --local-dir models

Next, download SAM2 sam2_hiera_large.pt and place it at:

sam2/SAM2-Video-Predictor/checkpoints/

We recommend to organize local directories as:

Refacade
โ”œโ”€โ”€ ...
โ”œโ”€โ”€ examples
โ”œโ”€โ”€ models
โ”‚   โ”œโ”€โ”€ refacade
โ”‚   โ”‚   โ””โ”€โ”€ ...
โ”‚   โ”œโ”€โ”€ texture_remover
โ”‚   โ”‚   โ””โ”€โ”€ ...
โ”‚   โ””โ”€โ”€ vae
โ”‚       โ””โ”€โ”€ ...
โ”œโ”€โ”€ sam2
โ””โ”€โ”€ ...