Update README
Browse files
README.md
CHANGED
|
@@ -57,82 +57,39 @@ LoomVideo supports **four** unified video generation and editing tasks within a
|
|
| 57 |
| **Instruction-Image Editing** | Video π¬ + Image πΌ + Text π | Video π¬ | Edit a video with a reference image as guidance |
|
| 58 |
| **Multi-Image-to-Video** | Images πΌ + Text π | Video π¬ | Compose multiple reference images into a coherent video |
|
| 59 |
|
| 60 |
-
#
|
| 61 |
-
|
| 62 |
-
<p align="center">
|
| 63 |
-
<img src="assets/results_1/t2v_demo.gif" width="480"/>
|
| 64 |
-
</p>
|
| 65 |
-
|
| 66 |
-
> **Prompt:** *Snow rocky mountains peaks canyon. Snow blanketed rocky mountains surround and shadow deep canyons. The canyons twist and bend through the high elevated mountain peaks.*
|
| 67 |
-
|
| 68 |
-
<p align="center">
|
| 69 |
-
<img src="assets/results_2/t2v_demo.gif" width="480"/>
|
| 70 |
-
</p>
|
| 71 |
-
|
| 72 |
-
> **Prompt:** *Vampire makeup face of beautiful girl, red contact lenses.*
|
| 73 |
-
|
| 74 |
-
### βοΈ Instruction Editing
|
| 75 |
-
|
| 76 |
-
<p align="center">
|
| 77 |
-
<img src="assets/results_1/edit_input.gif" height="180"/>
|
| 78 |
-
<b> β </b>
|
| 79 |
-
<img src="assets/results_1/edit_demo.gif" height="180"/>
|
| 80 |
-
</p>
|
| 81 |
-
|
| 82 |
-
> **Prompt:** *Apply the Impressionist aesthetic to this video, ensuring seamless temporal consistency across all frames. The result should emulate the fluid brushstroke techniques and atmospheric focus of 19th-century Impressionist art, with each frame retaining the original motion, character actions, and camera movements.*
|
| 83 |
-
|
| 84 |
-
<p align="center">
|
| 85 |
-
<img src="assets/results_2/edit_input.gif" height="180"/>
|
| 86 |
-
<b> β </b>
|
| 87 |
-
<img src="assets/results_2/edit_demo.gif" height="180"/>
|
| 88 |
-
</p>
|
| 89 |
-
|
| 90 |
-
> **Prompt:** *Replace the tree with a golden-leaved tree that shimmers softly, ensuring it maintains the same position and pose within the video scene.*
|
| 91 |
-
|
| 92 |
-
### πΌοΈ Instruction-Image Editing
|
| 93 |
-
|
| 94 |
-
<p align="center">
|
| 95 |
-
<img src="assets/results_1/ref_edit_input.gif" height="180"/>
|
| 96 |
-
<img src="assets/results_1/ref_edit_reference.jpg" height="100"/>
|
| 97 |
-
<b> β </b>
|
| 98 |
-
<img src="assets/results_1/ref_edit_demo.gif" height="180"/>
|
| 99 |
-
</p>
|
| 100 |
|
| 101 |
-
|
| 102 |
|
| 103 |
-
|
| 104 |
-
|
| 105 |
-
|
| 106 |
-
|
| 107 |
-
<img src="assets/results_2/ref_edit_demo.gif" height="180"/>
|
| 108 |
-
</p>
|
| 109 |
|
| 110 |
-
|
| 111 |
|
| 112 |
-
|
| 113 |
|
| 114 |
-
|
| 115 |
-
|
| 116 |
-
|
| 117 |
-
<img src="assets/results_1/mi2v_input_3.jpg" height="140"/>
|
| 118 |
-
<b> β </b>
|
| 119 |
-
<img src="assets/results_1/mi2v_demo.gif" height="180"/>
|
| 120 |
-
</p>
|
| 121 |
|
| 122 |
-
|
|
|
|
|
|
|
| 123 |
|
| 124 |
-
|
| 125 |
-
<img src="assets/results_2/mi2v_input_1.jpg" height="140"/>
|
| 126 |
-
<img src="assets/results_2/mi2v_input_2.jpg" height="140"/>
|
| 127 |
-
<b> β </b>
|
| 128 |
-
<img src="assets/results_2/mi2v_demo.gif" height="180"/>
|
| 129 |
-
</p>
|
| 130 |
|
| 131 |
-
|
| 132 |
|
|
|
|
| 133 |
|
| 134 |
-
|
|
|
|
|
|
|
|
|
|
| 135 |
|
|
|
|
| 136 |
|
| 137 |
# π¬ Inference
|
| 138 |
LoomVideo provides a unified inference script that supports **four generation tasks** through a single entry point. Each task is selected via the `--task` flag.
|
|
|
|
| 57 |
| **Instruction-Image Editing** | Video π¬ + Image πΌ + Text π | Video π¬ | Edit a video with a reference image as guidance |
|
| 58 |
| **Multi-Image-to-Video** | Images πΌ + Text π | Video π¬ | Compose multiple reference images into a coherent video |
|
| 59 |
|
| 60 |
+
# π§ Preparation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 61 |
|
| 62 |
+
## Step 1: Clone the Repository
|
| 63 |
|
| 64 |
+
```bash
|
| 65 |
+
git clone TODO
|
| 66 |
+
cd LoomVideo
|
| 67 |
+
```
|
|
|
|
|
|
|
| 68 |
|
| 69 |
+
## Step 2: Install Dependencies
|
| 70 |
|
| 71 |
+
We recommend using [uv](https://github.com/astral-sh/uv) for a fast and fully reproducible environment setup.
|
| 72 |
|
| 73 |
+
```bash
|
| 74 |
+
uv sync
|
| 75 |
+
source .venv/bin/activate
|
|
|
|
|
|
|
|
|
|
|
|
|
| 76 |
|
| 77 |
+
# (Optional) Include evaluation dependencies
|
| 78 |
+
uv sync --extra eval
|
| 79 |
+
```
|
| 80 |
|
| 81 |
+
Additionally, install [Flash Attention](https://github.com/Dao-AILab/flash-attention) for faster inference and reduced GPU memory consumption. (for reference, our environment uses v2.7.4)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 82 |
|
| 83 |
+
## Step 3: Download Model Weights
|
| 84 |
|
| 85 |
+
Download the pretrained LoomVideo checkpoint from [Hugging Face](https://huggingface.co/MSALab/LoomVideo) and place it under `checkpoints/LoomVideo/`:
|
| 86 |
|
| 87 |
+
```
|
| 88 |
+
checkpoints/LoomVideo/
|
| 89 |
+
βββ gen_model.pth
|
| 90 |
+
```
|
| 91 |
|
| 92 |
+
You can also specify a custom path via the `--ckpt_path` argument at inference time.
|
| 93 |
|
| 94 |
# π¬ Inference
|
| 95 |
LoomVideo provides a unified inference script that supports **four generation tasks** through a single entry point. Each task is selected via the `--task` flag.
|