diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..bab002189355d42f5aba56499d615fa23e43e745
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright 2023 MagicAnimate Team All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
\ No newline at end of file
diff --git a/README.md b/README.md
index 689d44137e986820d38ecc07d357da5c865a53b2..851dd02426b3fa1a28bb50d1d644f75b222cac6d 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,128 @@
----
-title: Magicanimate
-emoji: 📊
-colorFrom: yellow
-colorTo: pink
-sdk: gradio
-sdk_version: 4.7.1
-app_file: app.py
-pinned: false
-license: bsd-3-clause
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+
+
+
+
MagicAnimate: Temporally Consistent Human Image Animation using Diffusion Model
+
+ Zhongcong Xu
+ ·
+ Jianfeng Zhang
+ ·
+ Jun Hao Liew
+ ·
+ Hanshu Yan
+ ·
+ Jia-Wei Liu
+ ·
+ Chenxu Zhang
+ ·
+ Jiashi Feng
+ ·
+ Mike Zheng Shou
+
+
+ 
+ 
+ 
+
+ National University of Singapore | ByteDance
+
+
+
+
+
+ 
+ |
+
+ 
+ |
+
+
+
+ 
+ |
+
+ 
+ |
+
+
+
+## 📢 News
+* **[2023.12.4]** Release inference code and gradio demo. We are working to improve MagicAnimate, stay tuned!
+* **[2023.11.23]** Release MagicAnimate paper and project page.
+
+## 🏃♂️ Getting Started
+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).
+
+Download our MagicAnimate [checkpints](https://huggingface.co/zcxu-eric/MagicAnimate).
+
+**Place them as following:**
+```bash
+magic-animate
+|----pretrained_models
+ |----MagicAnimate
+ |----appearance_encoder
+ |----diffusion_pytorch_model.safetensors
+ |----config.json
+ |----densepose_controlnet
+ |----diffusion_pytorch_model.safetensors
+ |----config.json
+ |----temporal_attention
+ |----temporal_attention.ckpt
+ |----sd-vae-ft-mse
+ |----...
+ |----stable-diffusion-v1-5
+ |----...
+|----...
+```
+
+## ⚒️ Installation
+prerequisites: `python>=3.8`, `CUDA>=11.3`, and `ffmpeg`.
+
+Install with `conda`:
+```bash
+conda env create -f environment.yml
+conda activate manimate
+```
+or `pip`:
+```bash
+pip3 install -r requirements.txt
+```
+
+## 💃 Inference
+Run inference on single GPU:
+```bash
+bash scripts/animate.sh
+```
+Run inference with multiple GPUs:
+```bash
+bash scripts/animate_dist.sh
+```
+
+## 🎨 Gradio Demo
+
+#### Online Gradio Demo:
+Try our [online gradio demo]() quickly.
+
+#### Local Gradio Demo:
+Launch local gradio demo on single GPU:
+```bash
+python3 -m demo.gradio_animate
+```
+Launch local gradio demo if you have multiple GPUs:
+```bash
+python3 -m demo.gradio_animate_dist
+```
+Then open gradio demo in local browser.
+
+## 🎓 Citation
+If you find this codebase useful for your research, please use the following entry.
+```BibTeX
+@inproceedings{xu2023magicanimate,
+ 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},
+ title = {MagicAnimate: Temporally Consistent Human Image Animation using Diffusion Model},
+ booktitle = {arXiv},
+ year = {2023}
+}
+```
+
diff --git a/app.py b/app.py
new file mode 100644
index 0000000000000000000000000000000000000000..01b8fd5a9e113f6a78257a6d34501dfa4a266c6f
--- /dev/null
+++ b/app.py
@@ -0,0 +1,107 @@
+# Copyright 2023 ByteDance and/or its affiliates.
+#
+# Copyright (2023) MagicAnimate Authors
+#
+# ByteDance, its affiliates and licensors retain all intellectual
+# property and proprietary rights in and to this material, related
+# documentation and any modifications thereto. Any use, reproduction,
+# disclosure or distribution of this material and related documentation
+# without an express license agreement from ByteDance or
+# its affiliates is strictly prohibited.
+import argparse
+import imageio
+import numpy as np
+import gradio as gr
+from PIL import Image
+from subprocess import PIPE, run
+
+from demo.animate import MagicAnimate
+
+for command in [
+ 'mkdir ./pretrained_models && cd pretrained_models',
+ 'git lfs clone https://huggingface.co/zcxu-eric/MagicAnimate',
+ 'git lfs clone https://huggingface.co/runwayml/stable-diffusion-v1-5',
+ 'git lfs clone https://huggingface.co/stabilityai/sd-vae-ft-mse',
+ 'cd ..',
+]:
+ run(command, stdout=PIPE, stderr=PIPE, universal_newlines=True, shell=True)
+
+animator = MagicAnimate()
+
+def animate(reference_image, motion_sequence_state, seed, steps, guidance_scale):
+ return animator(reference_image, motion_sequence_state, seed, steps, guidance_scale)
+
+with gr.Blocks() as demo:
+
+ gr.HTML(
+ """
+
+
+ MagicAnimate: Temporally Consistent Human Image Animation
+
+
+
+