https://github.com/modeltc/lightx2v
Light Video Generation Inference Framework
https://github.com/modeltc/lightx2v
diffusion-models hunyuan-video video-generation wan-video
Last synced: 5 months ago
JSON representation
Light Video Generation Inference Framework
- Host: GitHub
- URL: https://github.com/modeltc/lightx2v
- Owner: ModelTC
- Created: 2025-03-24T10:27:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-07T03:16:45.000Z (5 months ago)
- Last Synced: 2025-05-07T19:57:43.699Z (5 months ago)
- Topics: diffusion-models, hunyuan-video, video-generation, wan-video
- Language: Python
- Homepage:
- Size: 1.08 MB
- Stars: 15
- Watchers: 5
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# LightX2V: Light Video Generation Inference Framework
--------------------------------------------------------------------------------
## Supported Model List
✅ [HunyuanVideo-T2V](https://huggingface.co/tencent/HunyuanVideo)
✅ [HunyuanVideo-I2V](https://huggingface.co/tencent/HunyuanVideo-I2V)
✅ [Wan2.1-T2V](https://huggingface.co/Wan-AI/Wan2.1-T2V-1.3B)
✅ [Wan2.1-I2V](https://huggingface.co/Wan-AI/Wan2.1-I2V-14B-480P)
✅ [Wan2.1-T2V-CausVid](https://huggingface.co/lightx2v/Wan2.1-T2V-14B-CausVid)
✅ [SkyReels-V2-DF](https://huggingface.co/Skywork/SkyReels-V2-DF-14B-540P)
## Build Env With Conda
```shell
# clone repo and submodules
git clone https://github.com/ModelTC/lightx2v.git lightx2v && cd lightx2v
git submodule update --init --recursive
# create conda env and install requirments
conda create -n lightx2v python=3.11 && conda activate lightx2v
pip install -r requirements.txt
# Install again separately to bypass the version conflict check
pip install transformers==4.45.2
# install flash-attention 2
cd lightx2v/3rd/flash-attention && pip install --no-cache-dir -v -e .
# install flash-attention 3, only if hopper
cd lightx2v/3rd/flash-attention/hopper && pip install --no-cache-dir -v -e .
```
## Build Env With Docker
```shell
docker pull lightx2v/lightx2v:latest
docker run -it --rm --name lightx2v --gpus all --ipc=host lightx2v/lightx2v:latest
```
## Run
Infer
```shell
# modify the parameters of the running script
bash scripts/run_hunyuan_t2v.sh
```
Start A Server
```shell
# modify the parameters of the running script
bash scripts/start_server.sh
# modify the message of the post.py
python post.py
```
## Contributing Guidelines
We have prepared a `pre-commit` hook to enforce consistent code formatting across the project. If your code complies with the standards, you should not see any errors, you can clean up your code following the steps below:
1. Install the required dependencies:
```shell
pip install ruff pre-commit
```
2. Then, run the following command before commit:
```shell
pre-commit run --all-files
```
3. Finally, please double-check your code to ensure it complies with the following additional specifications as much as possible:
- Avoid hard-coding local paths: Make sure your submissions do not include hard-coded local paths, as these paths are specific to individual development environments and can cause compatibility issues. Use relative paths or configuration files instead.
- Clear error handling: Implement clear error-handling mechanisms in your code so that error messages can accurately indicate the location of the problem, possible causes, and suggested solutions, facilitating quick debugging.
- Detailed comments and documentation: Add comments to complex code sections and provide comprehensive documentation to explain the functionality of the code, input-output requirements, and potential error scenarios.
Thank you for your contributions!