basetenlabs/LatentSync

basetenlabs/LatentSync

Description: Taming Stable Diffusion for Lip Sync!

License: Apache-2.0

Stars: 1

Forks: 0

Open issues: 4

Created: 2025-06-26T14:06:57Z

Pushed: 2026-05-08T17:27:00Z

Default branch: main

Fork: yes

Parent repository: bytedance/LatentSync

Archived: no

README: LatentSync

🔥 Updates

• 2025/06/11: We released LatentSync 1.6, which is trained on 512 $\times$ 512 resolution videos to mitigate the blurriness problem. Watch the demo [here](docs/changelog_v1.6.md).

• 2025/03/14: We released LatentSync 1.5, which (1) improves temporal consistency via adding temporal layer, (2) improves performance on Chinese videos and (3) reduces the VRAM requirement of the stage2 training to 20 GB through a series of optimizations. Learn more details [here](docs/changelog_v1.5.md).

📖 Introduction

We present *LatentSync*, an end-to-end lip-sync method based on audio-conditioned latent diffusion models without any intermediate motion representation, diverging from previous diffusion-based lip-sync methods based on pixel-space diffusion or two-stage generation. Our framework can leverage the powerful capabilities of Stable Diffusion to directly model complex audio-visual correlations.

🏗️ Framework

LatentSync uses the Whisper to convert melspectrogram into audio embeddings, which are then integrated into the U-Net via cross-attention layers. The reference and masked frames are channel-wise concatenated with noised latents as the input of U-Net. In the training process, we use a one-step method to get estimated clean latents from predicted noises, which are then decoded to obtain the estimated clean frames. The TREPA, LPIPS and SyncNet losses are added in the pixel space.

🎬 Demo

Original video Lip-synced video

(Photorealistic videos are filmed by contracted models, and anime videos are from VASA-1)

📑 Open-source Plan

• [x] Inference code and checkpoints
• [x] Data processing pipeline
• [x] Training code

🔧 Setting up the Environment

Install the required packages and download the checkpoints via:

source setup_env.sh

If the download is successful, the checkpoints should appear as follows:

./checkpoints/
|-- latentsync_unet.pt
|-- whisper
| `-- tiny.pt

Or you can download latentsync_unet.pt and tiny.pt manually from our HuggingFace repo

🚀 Inference

Minimum VRAM for inference:

• 8 GB with LatentSync 1.5
• 18 GB with LatentSync 1.6

There are two ways to perform inference:

1. Gradio App

Run the Gradio app for inference:

python gradio_app.py

2. Command Line Interface

Run the script for inference:

./inference.sh

You can try adjusting the following inference parameters to achieve better results:

• inference_steps [20-50]: A higher value improves visual quality but slows down the generation speed.
• guidance_scale [1.0-3.0]: A higher value improves lip-sync accuracy but may cause the video distortion or jitter.

🔄 Data Processing Pipeline

The complete data processing pipeline includes the following steps:

1. Remove the broken video files. 2. Resample the video FPS to 25, and resample the audio to 16000 Hz. 3. Scene detect via PySceneDetect. 4. Split each video into 5-10 second segments. 5. Affine transform the faces according to the landmarks detected by InsightFace, then resize to 256 $\times$ 256. 6. Remove videos with sync confidence score lower than 3, and adjust the audio-visual offset to 0. 7. Calculate hyperIQA score, and remove videos with scores lower than 40.

Run the script to execute the data processing pipeline:

./data_processing_pipeline.sh

You should change the parameter input_dir in the script to specify the data directory to be processed. The processed videos will be saved in the high_visual_quality directory. Each step will generate a new directory to prevent the need to redo the entire pipeline in case the process is interrupted by an unexpected error.

🏋️‍♂️ Training U-Net

Before training, you should process the data as described above. We released a pretrained SyncNet with 94% accuracy on both VoxCeleb2 and HDTF datasets for the supervision of U-Net training. You can execute the following command to download this SyncNet checkpoint:

huggingface-cli download ByteDance/LatentSync-1.6 stable_syncnet.pt --local-dir checkpoints

If all the preparations are complete, you can train the U-Net with the following script:

./train_unet.sh

We prepared several UNet configuration files in the `configs/unet` directory, each corresponding to a specific training setup:

• stage1.yaml: Stage1 training, requires 23 GB VRAM.
• stage2.yaml: Stage2 training with optimal performance, requires 30 GB VRAM.
• stage2_efficient.yaml: Efficient Stage 2 training, requires 20 GB VRAM. It may lead to slight degradation in visual quality and temporal consistency compared with stage2.yaml, suitable for users with consumer-grade GPUs, such as the RTX 3090.
• stage1_512.yaml: Stage1 training on 512 $\times$ 512 resolution videos, requires 30 GB VRAM.
• stage2_512.yaml: Stage2 training on 512 $\times$ 512 resolution videos, requires 55 GB VRAM.

Also remember to change the parameters in U-Net config file to specify the data directory, checkpoint save path, and other training hyperparameters. For convenience, we prepared a script for writing a data files list. Run the following command:

python -m tools.write_fileslist

🏋️‍♂️ Training SyncNet

In case you want to train SyncNet on your own datasets, you can run the following script. The data processing pipeline for SyncNet is the same as U-Net.

./train_syncnet.sh

After validations_steps training, the loss charts will be saved in train_output_dir. They contain both the training and validation loss. If you want to customize…