---

🌟 What's Special?

---

📦 Model Catalog

🎥 Model Types

🎯 Precision Variants

📝 Naming Convention

# Pattern: wan2.1_{task}_{resolution}_{precision}.safetensors

# Examples:
wan2.1_i2v_720p_lightx2v_4step.safetensors                          # 720P I2V - BF16
wan2.1_i2v_720p_scaled_fp8_e4m3_lightx2v_4step.safetensors         # 720P I2V - FP8
wan2.1_i2v_480p_int8_lightx2v_4step.safetensors                    # 480P I2V - INT8
wan2.1_t2v_14b_scaled_fp8_e4m3_lightx2v_4step_comfyui.safetensors  # T2V - FP8 ComfyUI

💡 Explore all models: Browse Full Model Collection →

🚀 Usage

LightX2V is a high-performance inference framework optimized for these models, approximately 2x faster than ComfyUI with better quantization accuracy. Highly recommended!

Quick Start

1. Download model (720P I2V FP8 example)

huggingface-cli download lightx2v/Wan2.1-Distill-Models \
    --local-dir ./models/wan2.1_i2v_720p \
    --include "wan2.1_i2v_720p_scaled_fp8_e4m3_lightx2v_4step.safetensors"

2. Clone LightX2V repository

git clone https://github.com/ModelTC/LightX2V.git
cd LightX2V

3. Install dependencies

pip install -r requirements.txt

Or refer to Quick Start Documentation to use docker

4. Select and modify configuration file

Choose the appropriate configuration based on your GPU memory:

For 80GB+ GPU (A100/H100)

• I2V: wan_i2v_distill_4step_cfg.json
• T2V: wan_t2v_distill_4step_cfg.json

For 24GB+ GPU (RTX 4090)

• I2V: wan_i2v_distill_4step_cfg_4090.json
• T2V: wan_t2v_distill_4step_cfg_4090.json

5. Run inference

cd scripts
bash wan/run_wan_i2v_distill_4step_cfg.sh

Documentation

• Quick Start Guide: LightX2V Quick Start
• Complete Usage Guide: LightX2V Model Structure Documentation
• Configuration Guide: Configuration Files
• Quantization Usage: Quantization Documentation
• Parameter Offload: Offload Documentation

Performance Advantages

• ⚡ Fast: Approximately 2x faster than ComfyUI
• 🎯 Optimized: Deeply optimized for distilled models
• 💾 Memory Efficient: Supports CPU offload and other memory optimization techniques
• 🛠️ Flexible: Supports multiple quantization formats and configuration options

Community

• Issues: https://github.com/ModelTC/LightX2V/issues

⚠️ Important Notes

1. Additional Components: These models only contain DIT weights. You also need:

   • T5 text encoder
   • CLIP vision encoder
   • VAE encoder/decoder
   • Tokenizers

   Refer to LightX2V Documentation for how to organize the complete model directory.

If you find this project helpful, please give us a ⭐ on GitHub