zcxu-eric commited on
Commit
10378b6
1 Parent(s): 8aa9c9a
Files changed (1) hide show
  1. README.md +9 -128
README.md CHANGED
@@ -1,128 +1,9 @@
1
- <!-- # magic-edit.github.io -->
2
-
3
- <p align="center">
4
-
5
- <h2 align="center">MagicAnimate: Temporally Consistent Human Image Animation using Diffusion Model</h2>
6
- <p align="center">
7
- <a href="https://scholar.google.com/citations?user=-4iADzMAAAAJ&hl=en"><strong>Zhongcong Xu</strong></a>
8
- ·
9
- <a href="http://jeff95.me/"><strong>Jianfeng Zhang</strong></a>
10
- ·
11
- <a href="https://scholar.google.com.sg/citations?user=8gm-CYYAAAAJ&hl=en"><strong>Jun Hao Liew</strong></a>
12
- ·
13
- <a href="https://hanshuyan.github.io/"><strong>Hanshu Yan</strong></a>
14
- ·
15
- <a href="https://scholar.google.com/citations?user=stQQf7wAAAAJ&hl=en"><strong>Jia-Wei Liu</strong></a>
16
- ·
17
- <a href="https://zhangchenxu528.github.io/"><strong>Chenxu Zhang</strong></a>
18
- ·
19
- <a href="https://sites.google.com/site/jshfeng/home"><strong>Jiashi Feng</strong></a>
20
- ·
21
- <a href="https://sites.google.com/view/showlab"><strong>Mike Zheng Shou</strong></a>
22
- <br>
23
- <br>
24
- <a href="https://arxiv.org/abs/2311.16498"><img src='https://img.shields.io/badge/arXiv-MagicAnimate-red' alt='Paper PDF'></a>
25
- <a href='https://showlab.github.io/magicanimate'><img src='https://img.shields.io/badge/Project_Page-MagicAnimate-green' alt='Project Page'></a>
26
- <a href=''><img src='https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue'></a>
27
- <br>
28
- <b>National University of Singapore &nbsp; | &nbsp; ByteDance</b>
29
- </p>
30
-
31
- <table align="center">
32
- <tr>
33
- <td>
34
- <img src="assets/teaser/t1.gif">
35
- </td>
36
- <td>
37
- <img src="assets/teaser/t4.gif">
38
- </td>
39
- </tr>
40
- <tr>
41
- <td>
42
- <img src="assets/teaser/t3.gif">
43
- </td>
44
- <td>
45
- <img src="assets/teaser/t2.gif">
46
- </td>
47
- </tr>
48
- </table>
49
-
50
- ## 📢 News
51
- * **[2023.12.4]** Release inference code and gradio demo. We are working to improve MagicAnimate, stay tuned!
52
- * **[2023.11.23]** Release MagicAnimate paper and project page.
53
-
54
- ## 🏃‍♂️ Getting Started
55
- Please download the pretrained base models for [StableDiffusion V1.5](https://huggingface.co/runwayml/stable-diffusion-v1-5) and [MSE-finetuned VAE](https://huggingface.co/stabilityai/sd-vae-ft-mse).
56
-
57
- Download our MagicAnimate [checkpints](https://huggingface.co/zcxu-eric/MagicAnimate).
58
-
59
- **Place them as following:**
60
- ```bash
61
- magic-animate
62
- |----pretrained_models
63
- |----MagicAnimate
64
- |----appearance_encoder
65
- |----diffusion_pytorch_model.safetensors
66
- |----config.json
67
- |----densepose_controlnet
68
- |----diffusion_pytorch_model.safetensors
69
- |----config.json
70
- |----temporal_attention
71
- |----temporal_attention.ckpt
72
- |----sd-vae-ft-mse
73
- |----...
74
- |----stable-diffusion-v1-5
75
- |----...
76
- |----...
77
- ```
78
-
79
- ## ⚒️ Installation
80
- prerequisites: `python>=3.8`, `CUDA>=11.3`, and `ffmpeg`.
81
-
82
- Install with `conda`:
83
- ```bash
84
- conda env create -f environment.yml
85
- conda activate manimate
86
- ```
87
- or `pip`:
88
- ```bash
89
- pip3 install -r requirements.txt
90
- ```
91
-
92
- ## 💃 Inference
93
- Run inference on single GPU:
94
- ```bash
95
- bash scripts/animate.sh
96
- ```
97
- Run inference with multiple GPUs:
98
- ```bash
99
- bash scripts/animate_dist.sh
100
- ```
101
-
102
- ## 🎨 Gradio Demo
103
-
104
- #### Online Gradio Demo:
105
- Try our [online gradio demo]() quickly.
106
-
107
- #### Local Gradio Demo:
108
- Launch local gradio demo on single GPU:
109
- ```bash
110
- python3 -m demo.gradio_animate
111
- ```
112
- Launch local gradio demo if you have multiple GPUs:
113
- ```bash
114
- python3 -m demo.gradio_animate_dist
115
- ```
116
- Then open gradio demo in local browser.
117
-
118
- ## 🎓 Citation
119
- If you find this codebase useful for your research, please use the following entry.
120
- ```BibTeX
121
- @inproceedings{xu2023magicanimate,
122
- author = {Xu, Zhongcong and Zhang, Jianfeng and Liew, Jun Hao and Yan, Hanshu and Liu, Jia-Wei and Zhang, Chenxu and Feng, Jiashi and Shou, Mike Zheng},
123
- title = {MagicAnimate: Temporally Consistent Human Image Animation using Diffusion Model},
124
- booktitle = {arXiv},
125
- year = {2023}
126
- }
127
- ```
128
-
 
1
+ title: MagicAnimate
2
+ emoji: 💃
3
+ colorFrom: purple
4
+ colorTo: purple
5
+ sdk: gradio
6
+ sdk_version: 4.4.0
7
+ python_version: 3.8
8
+ app_file: app.py
9
+ pinned: false