Intelligent Creation, ByteDance
* Equal Contribution
Tested on CUDA 12.4
conda create -n lynx python=3.10
conda activate lynx
pip install -r requirements.txt
# For lynx full model, flash attention is required
pip install flash_attn==2.7.4.post1 # flash attention 3 is also supported, will be faster- Base model: Download from Wan-AI/Wan2.1-T2V-14B-Diffusers, place it at
models/Wan2.1-T2V-14B-Diffusers - Lynx: Download
lynx_fullfrom ByteDance/lynx, place it atmodels/lynx_full - Lynx-lite: Download
lynx_litefrom ByteDance/lynx, place it atmodels/lynx_lite
Complete version with all advanced features and best performance.
Run a simple single-GPU inference:
python infer.py --subject_image demo/subjects/demo_subject.png --prompt "A person carves a pumpkin on a porch in the evening. The camera captures their upper body as they draw a face with a marker, carefully cut along the lines, then lift the lid with both hands. Their face lights up with excitement as they peek inside." --seed 42
python infer.py --subject_image demo/subjects/demo_subject.png --prompt demo/prompts/demo_prompt.txt --seed 42Lightweight model with fewer parameters (no Ref-adapter), tailored for efficient 24fps (121-frame) video generation.
Run a simple single-GPU inference:
python infer_lite.py --subject_image demo/subjects/demo_subject.png --prompt "A person carves a pumpkin on a porch in the evening. The camera captures their upper body as they draw a face with a marker, carefully cut along the lines, then lift the lid with both hands. Their face lights up with excitement as they peek inside." --seed 42
python infer_lite.py --subject_image demo/subjects/demo_subject.png --prompt demo/prompts/demo_prompt.txt --seed 42Copyright 2025 Bytedance Ltd. and/or its affiliates
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
If you find this code useful for your research, please cite us via the BibTeX below.
@article{sang2025lynx,
title = {Lynx: Towards High-Fidelity Personalized Video Generation},
author = {Sang, Shen and Zhi, Tiancheng and Gu, Tianpei and Liu, Jing and Luo, Linjie},
journal = {arXiv preprint arXiv:2509.15496},
year = {2025}
}
