Repolode
Alibaba-Quark

Alibaba-Quark/LiveAvatar

Open-source research framework for real-time, audio-driven avatar video generation with streaming, infinite-length output built on a 14B diffusion model.

Stars
2,483
Forks
286
Open issues
46
Last commit
2 months ago

What is it?

LiveAvatar generates talking avatar videos from an audio track and a reference image, with an optional text prompt. It is designed for streaming use: frames are produced continuously rather than as a single fixed-length clip, using a block-wise autoregressive approach that the project says supports videos over 10,000 seconds long.

The system is built on the Wan2.2-S2V-14B base model with a LiveAvatar LoRA, and uses 4-step sampling via distribution-matching distillation. The project reports about 45 FPS on multi-card H800 GPUs. Inference scripts cover multi-GPU real-time streaming, single-GPU offline generation on an 80GB card, and Gradio web UIs. Optional FP8 quantization targets 48GB GPUs, and compilation and cuDNN attention options are available for speed.

The project is released under Apache-2.0 and is described by its authors as a research preview. Model checkpoints are hosted on Hugging Face, and the repository lists pending work such as training code and TTS integration.

Key features

  • 01Real-time streaming audio-driven avatar video generation
  • 02Block-wise autoregressive generation for very long videos
  • 034-step sampling via distribution-matching distillation
  • 04Multi-GPU and single-GPU inference scripts
  • 05Gradio web UI for both single and multi-GPU setups
  • 06Optional FP8 quantization and compilation for speed and lower VRAM

Use cases

  • Building real-time interactive digital human or virtual host applications
  • Generating long-form talking avatar videos from audio
  • Researching audio-driven video generation with diffusion models
  • Running avatar generation on a single 80GB GPU for offline clips

Quick start

  1. 1

    Create and activate a conda environment

    conda create -n liveavatar python=3.10 -y && conda activate liveavatar
  2. 2

    Install PyTorch and FlashAttention, then Python requirements

    pip install torch==2.8.0 torchvision==0.23.0 --index-url https://download.pytorch.org/whl/cu128 && pip install flash-attn==2.8.3 --no-build-isolation && pip install -r requirements.txt
  3. 3

    Download the Wan2.2-S2V-14B base model and LiveAvatar LoRA into ./ckpt/

    huggingface-cli download Wan-AI/Wan2.2-S2V-14B --local-dir ./ckpt/Wan2.2-S2V-14B && huggingface-cli download Quark-Vision/Live-Avatar --local-dir ./ckpt/LiveAvatar
  4. 4

    Run single-GPU CLI inference (needs 80GB VRAM)

    bash infinite_inference_single_gpu.sh

Things to know

  • Real-time 45 FPS results require multi-GPU H800-class hardware, and the multi-GPU pipeline needs five GPUs.
  • Inference needs at least an 80GB VRAM GPU, or 48GB with FP8 and possible quality loss.
  • Requires downloading a 14B base model plus a LoRA, and FlashAttention installation.
  • The README describes it as a research preview, and the UI integration and training code are not yet released.

Topics

FAQ

What is LiveAvatar?
Open-source research framework for real-time, audio-driven avatar video generation with streaming, infinite-length output built on a 14B diffusion model. LiveAvatar generates talking avatar videos from an audio track and a reference image, with an optional text prompt. It is designed for streaming use: frames are produced continuously rather than as a single fixed-length clip, using a block-wise autoregressive approach that the project says supports videos over 10,000 seconds long.
Is LiveAvatar free to use? What license does it have?
LiveAvatar is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is LiveAvatar still maintained?
Updated within 6 months. The last commit to LiveAvatar was on Aug 24, 2026.
What can I use LiveAvatar for?
Building real-time interactive digital human or virtual host applications Generating long-form talking avatar videos from audio Researching audio-driven video generation with diffusion models Running avatar generation on a single 80GB GPU for offline clips
How do I install LiveAvatar?
Create and activate a conda environment: conda create -n liveavatar python=3.10 -y && conda activate liveavatar Install PyTorch and FlashAttention, then Python requirements: pip install torch==2.8.0 torchvision==0.23.0 --index-url https://download.pytorch.org/whl/cu128 && pip install flash-attn==2.8.3 --no-build-isolation && pip install -r requirements.txt Download the Wan2.2-S2V-14B base model and LiveAvatar LoRA into ./ckpt/: huggingface-cli download Wan-AI/Wan2.2-S2V-14B --local-dir ./ckpt/Wan2.2-S2V-14B && huggingface-cli download Quark-Vision/Live-Avatar --local-dir ./ckpt/LiveAvatar Run single-GPU CLI inference (needs 80GB VRAM): bash infinite_inference_single_gpu.sh
Where can I get LiveAvatar?
The source code and installation instructions are on GitHub: https://github.com/Alibaba-Quark/LiveAvatar

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects