Spaces:
Runtime error
Runtime error
update
Browse files
README.md
CHANGED
@@ -1,128 +1,9 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
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 | 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|