lightx2v commited on
Commit
a36df1d
Β·
verified Β·
1 Parent(s): deba612

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +95 -24
README.md CHANGED
@@ -11,43 +11,114 @@ base_model:
11
  - Wan-AI/Wan2.1-I2V-14B-720P
12
  library_name: diffusers
13
  ---
14
- # Wan2.1 Distilled Models
15
 
16
- This is a collection of distilled and accelerated versions of Wan2.1 video generation models, offering multiple precision and format options. All models are optimized for **4-step inference**, dramatically improving generation speed while maintaining high-quality outputs.
17
 
18
- ## πŸ“¦ Model Overview
19
 
20
- This repository provides multiple distilled versions of Wan2.1 models, covering different tasks, resolutions, and precisions:
21
 
22
- ### Model Types
23
 
24
- - **Image-to-Video (I2V)**: 480P / 720P resolutions
25
- - **Text-to-Video (T2V)**: 14B parameter version
 
26
 
27
- ### Precision Variants
28
 
29
- Each model is available in the following precision options:
30
 
31
- | Precision | Suffix Identifier | Size | Framework | Description |
32
- |-----------|-------------------|------|-----------|-------------|
33
- | **BF16** | `lightx2v_4step` | ~28-32 GB | LightX2V | Original precision, highest quality |
34
- | **FP8** | `scaled_fp8_e4m3_lightx2v_4step` | ~15-17 GB | LightX2V | FP8 quantization, half size |
35
- | **INT8** | `int8_lightx2v_4step` | ~15-17 GB | LightX2V | INT8 quantization, half size |
36
- | **FP8 ComfyUI** | `scaled_fp8_e4m3_lightx2v_4step_comfyui` | ~15-17 GB | ComfyUI | ComfyUI compatible format |
37
 
38
- ### Naming Convention Examples
 
 
39
 
40
- ```
41
- wan2.1_{task}_{resolution}_{precision}.safetensors
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
42
 
43
- Examples:
44
- - wan2.1_i2v_720p_lightx2v_4step.safetensors # 720P I2V original precision
45
- - wan2.1_i2v_720p_scaled_fp8_e4m3_lightx2v_4step.safetensors # 720P I2V FP8 quantization
46
- - wan2.1_i2v_480p_int8_lightx2v_4step.safetensors # 480P I2V INT8 quantization
47
- - wan2.1_t2v_14b_scaled_fp8_e4m3_lightx2v_4step_comfyui.safetensors # T2V ComfyUI scale_fp8 format
48
  ```
49
 
50
- > πŸ’‘ **Tip**: Browse [Files](https://huggingface.co/lightx2v/Wan2.1-Distill-Models/tree/main) to see all available models
51
 
52
  ## πŸš€ Usage
53
 
 
11
  - Wan-AI/Wan2.1-I2V-14B-720P
12
  library_name: diffusers
13
  ---
14
+ <div align="center">
15
 
16
+ # 🎬 Wan2.1 Distilled Models
17
 
18
+ ### ⚑ High-Performance Video Generation with 4-Step Inference
19
 
20
+ *Distilled and accelerated versions of Wan2.1 - Dramatically faster while maintaining exceptional quality*
21
 
22
+ ---
23
 
24
+ [![πŸ€— HuggingFace](https://img.shields.io/badge/πŸ€—-HuggingFace-yellow)](https://huggingface.co/lightx2v/Wan2.1-Distill-Models)
25
+ [![GitHub](https://img.shields.io/badge/GitHub-LightX2V-blue?logo=github)](https://github.com/ModelTC/LightX2V)
26
+ [![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](LICENSE)
27
 
28
+ </div>
29
 
30
+ ---
31
 
32
+ ## 🌟 What's Special?
 
 
 
 
 
33
 
34
+ <table>
35
+ <tr>
36
+ <td width="50%">
37
 
38
+ ### ⚑ Ultra-Fast Generation
39
+ - **4-step inference** (vs traditional 50+ steps)
40
+ - Up to **2x faster** than ComfyUI
41
+ - Real-time video generation capability
42
+
43
+ </td>
44
+ <td width="50%">
45
+
46
+ ### 🎯 Flexible Options
47
+ - Multiple resolutions (480P/720P)
48
+ - Various precision formats (BF16/FP8/INT8)
49
+ - I2V and T2V support
50
+
51
+ </td>
52
+ </tr>
53
+ <tr>
54
+ <td width="50%">
55
+
56
+ ### πŸ’Ύ Memory Efficient
57
+ - FP8/INT8: **~50% size reduction**
58
+ - CPU offload support
59
+ - Optimized for consumer GPUs
60
+
61
+ </td>
62
+ <td width="50%">
63
+
64
+ ### πŸ”§ Easy Integration
65
+ - Compatible with LightX2V framework
66
+ - ComfyUI support available
67
+ - Simple configuration files
68
+
69
+ </td>
70
+ </tr>
71
+ </table>
72
+
73
+ ---
74
+
75
+ ## πŸ“¦ Model Catalog
76
+
77
+ ### πŸŽ₯ Model Types
78
+
79
+ <table>
80
+ <tr>
81
+ <td align="center" width="50%">
82
+
83
+ #### πŸ–ΌοΈ **Image-to-Video (I2V)**
84
+ Transform still images into dynamic videos
85
+ - πŸ“Ί 480P Resolution
86
+ - 🎬 720P Resolution
87
+
88
+ </td>
89
+ <td align="center" width="50%">
90
+
91
+ #### πŸ“ **Text-to-Video (T2V)**
92
+ Generate videos from text descriptions
93
+ - πŸš€ 14B Parameters
94
+ - 🎨 High-quality synthesis
95
+
96
+ </td>
97
+ </tr>
98
+ </table>
99
+
100
+ ### 🎯 Precision Variants
101
+
102
+ | Precision | Model Identifier | Model Size | Framework | Quality vs Speed |
103
+ |:---------:|:-----------------|:----------:|:---------:|:-----------------|
104
+ | πŸ† **BF16** | `lightx2v_4step` | ~28-32 GB | LightX2V | ⭐⭐⭐⭐⭐ Highest quality |
105
+ | ⚑ **FP8** | `scaled_fp8_e4m3_lightx2v_4step` | ~15-17 GB | LightX2V | ⭐⭐⭐⭐ Excellent balance |
106
+ | 🎯 **INT8** | `int8_lightx2v_4step` | ~15-17 GB | LightX2V | ⭐⭐⭐⭐ Fast & efficient |
107
+ | πŸ”· **FP8 ComfyUI** | `scaled_fp8_e4m3_lightx2v_4step_comfyui` | ~15-17 GB | ComfyUI | ⭐⭐⭐⭐ ComfyUI ready |
108
+
109
+ ### πŸ“ Naming Convention
110
+
111
+ ```bash
112
+ # Pattern: wan2.1_{task}_{resolution}_{precision}.safetensors
113
 
114
+ # Examples:
115
+ wan2.1_i2v_720p_lightx2v_4step.safetensors # 720P I2V - BF16
116
+ wan2.1_i2v_720p_scaled_fp8_e4m3_lightx2v_4step.safetensors # 720P I2V - FP8
117
+ wan2.1_i2v_480p_int8_lightx2v_4step.safetensors # 480P I2V - INT8
118
+ wan2.1_t2v_14b_scaled_fp8_e4m3_lightx2v_4step_comfyui.safetensors # T2V - FP8 ComfyUI
119
  ```
120
 
121
+ > πŸ’‘ **Explore all models**: [Browse Full Model Collection β†’](https://huggingface.co/lightx2v/Wan2.1-Distill-Models/tree/main)
122
 
123
  ## πŸš€ Usage
124