FateZero / FateZero /README.md
chenyangqi's picture
add FateZero code
3060b7e

FateZero: Fusing Attentions for Zero-shot Text-based Video Editing

Chenyang Qi, Xiaodong Cun, Yong Zhang, Chenyang Lei, Xintao Wang, Ying Shan, and Qifeng Chen

Open In Colab GitHub

"silver jeep ➜ posche car" "+ Van Gogh style"

Abstract

TL;DR: Using FateZero, Edits your video via pretrained Diffusion models without training.

CLICK for full abstract

The diffusion-based generative models have achieved remarkable success in text-based image generation. However, since it contains enormous randomness in generation progress, it is still challenging to apply such models for real-world visual content editing, especially in videos. In this paper, we propose FateZero, a zero-shot text-based editing method on real-world videos without per-prompt training or use-specific mask. To edit videos consistently, we propose several techniques based on the pre-trained models. Firstly, in contrast to the straightforward DDIM inversion technique, our approach captures intermediate attention maps during inversion, which effectively retain both structural and motion information. These maps are directly fused in the editing process rather than generated during denoising. To further minimize semantic leakage of the source video, we then fuse self-attentions with a blending mask obtained by cross-attention features from the source prompt. Furthermore, we have implemented a reform of the self-attention mechanism in denoising UNet by introducing spatial-temporal attention to ensure frame consistency. Yet succinct, our method is the first one to show the ability of zero-shot text-driven video style and local attribute editing from the trained text-to-image model. We also have a better zero-shot shape-aware editing ability based on the text-tovideo model. Extensive experiments demonstrate our superior temporal consistency and editing capability than previous works.

Changelog

  • 2023.03.27 Release attribute editing config and data used in the paper.
  • 2023.03.22 Upload a colab notebook Open In Colab. Enjoy the fun of zero-shot video-editing freely!
  • 2023.03.22 Release style editing config and data used in the paper.
  • 2023.03.21 Editing guidance is provided to help users to edit in-the-wild video. Welcome to play and give feedback!
  • 2023.03.21 Update the codebase and configuration. Now, it can run with lower resources (16G GPU and less than 16G CPU RAM) with new configuration in config/low_resource_teaser.
  • 2023.03.17 Release Code and Paper!

Todo

  • Release the edit config for teaser
  • Memory and runtime profiling
  • Hands-on guidance of hyperparameters tuning
  • Colab
  • Release configs for other result and in-the-wild dataset
  • [-] hugging-face: inprogress
  • Tune-a-video optimization and shape editing configs
  • Release more application

Setup Environment

Our method is tested using cuda11, fp16 of accelerator and xformers on a single A100 or 3090.

conda create -n fatezero38 python=3.8
conda activate fatezero38

pip install -r requirements.txt

xformers is recommended for A100 GPU to save memory and running time.

Click for xformers installation

We find its installation not stable. You may try the following wheel:

wget https://github.com/ShivamShrirao/xformers-wheels/releases/download/4c06c79/xformers-0.0.15.dev0+4c06c79.d20221201-cp38-cp38-linux_x86_64.whl
pip install xformers-0.0.15.dev0+4c06c79.d20221201-cp38-cp38-linux_x86_64.whl

Validate the installation by

python test_install.py

Our environment is similar to Tune-A-video (official, unofficial) and prompt-to-prompt. You may check them for more details.

FateZero Editing

Style and Attribute Editing in Teaser

Download the stable diffusion v1-4 (or other interesting image diffusion model) and put it to ./ckpt/stable-diffusion-v1-4.

Click for bash command:
mkdir ./ckpt
# download from huggingface face, takes 20G space
git lfs install
git clone https://huggingface.co/CompVis/stable-diffusion-v1-4
cd ./ckpt
ln -s ../stable-diffusion-v1-4 .

Then, you could reproduce style and shape editing result in our teaser by running:

accelerate launch test_fatezero.py --config config/teaser/jeep_watercolor.yaml
# or CUDA_VISIBLE_DEVICES=0 python test_fatezero.py --config config/teaser/jeep_watercolor.yaml
The result is saved at `./result` . (Click for directory structure)
result
├── teaser
│   ├── jeep_posche
│   ├── jeep_watercolor
│           ├── cross-attention  # visualization of cross-attention during inversion
│           ├── sample           # result
│           ├── train_samples    # the input video

Editing 8 frames on an Nvidia 3090, use 100G CPU memory, 12G GPU memory for editing. We also provide some low cost setting of style editing by different hyper-parameters on a 16GB GPU. You may try these low cost setting on colab. Open In Colab

More the speed and hardware benchmark here.

Shape and large motion editing with Tune-A-Video

Besides style and attribution editing above, we also provide a Tune-A-Video checkpoint. You may download the it and move it to ./ckpt/jeep_tuned_200/.

The directory structure should like this: (Click for directory structure)
ckpt
├── stable-diffusion-v1-4
├── jeep_tuned_200
...
data
├── car-turn
│   ├── 00000000.png
│   ├── 00000001.png
│   ├── ...
video_diffusion

You could reproduce the shape editing result in our teaser by running:

accelerate launch test_fatezero.py --config config/teaser/jeep_posche.yaml

Reproduce other results in the paper (in progress)

Download the data of style editing and attribute editing from onedrive or from Github Release.

Click for wget bash command:
wget https://github.com/ChenyangQiQi/FateZero/releases/download/v0.0.1/attribute.zip
wget https://github.com/ChenyangQiQi/FateZero/releases/download/v0.0.1/style.zip

Unzip and Place it in './data'. Then use the command in 'config/style' and 'config/attribute' to get the results.

The config of our tune-a-video ckpts will be updated latter.

Tuning guidance to edit YOUR video

We provided a tuning guidance to edit in-the-wild video at here. The work is still in progress. Welcome to give your feedback in issues.

Style Editing Results with Stable Diffusion

We show the difference of source prompt and target prompt in the box below each video.

Note mp4 and gif files in this github page are compressed. Please check our Project Page for mp4 files of original video editing results.

"+ Ukiyo-e style" "+ watercolor painting" "+ Monet style"
"+ Pokémon cartoon style" "+ Makoto Shinkai style" "+ cartoon style"

Attribute Editing Results with Stable Diffusion

"rabbit, strawberry ➜ white rabbit, flower" "rabbit, strawberry ➜ squirrel, carrot" "rabbit, strawberry ➜ white rabbit, leaves"
"squirrel ➜ robot squirrel" "squirrel, Carrot ➜ rabbit, eggplant" "squirrel, Carrot ➜ robot mouse, screwdriver"
"bear ➜ a red tiger" "bear ➜ a yellow leopard" "bear ➜ a brown lion"
"cat ➜ black cat, grass..." "cat ➜ red tiger" "cat ➜ Shiba-Inu"
"bus ➜ GPU" "gray dog ➜ yellow corgi" "gray dog ➜ robotic dog"
"white duck ➜ yellow rubber duck" "grass ➜ snow" "white fox ➜ grey wolf"

Shape and large motion editing with Tune-A-Video

"silver jeep ➜ posche car" "Swan ➜ White Duck" "Swan ➜ Pink flamingo"
"A man ➜ A Batman" "A man ➜ A Wonder Woman, With cowboy hat" "A man ➜ A Spider-Man"

Demo Video

https://user-images.githubusercontent.com/45789244/225698509-79c14793-3153-4bba-9d6e-ede7d811d7f8.mp4

The video here is compressed due to the size limit of github. The original full resolution video is here.

Citation

@misc{qi2023fatezero,
      title={FateZero: Fusing Attentions for Zero-shot Text-based Video Editing}, 
      author={Chenyang Qi and Xiaodong Cun and Yong Zhang and Chenyang Lei and Xintao Wang and Ying Shan and Qifeng Chen},
      year={2023},
      eprint={2303.09535},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}

Acknowledgements

This repository borrows heavily from Tune-A-Video and prompt-to-prompt. thanks the authors for sharing their code and models.

Maintenance

This is the codebase for our research work. We are still working hard to update this repo and more details are coming in days. If you have any questions or ideas to discuss, feel free to contact Chenyang Qi or Xiaodong Cun.