ConfigsJul 22, 2026·2 min read

SadTalker — Audio-Driven Talking Face Animation

A CVPR 2023 method that animates a single portrait image into a realistic talking head video driven by audio input.

Agent ready

Ready-to-run agent install

This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.

Native · 98/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Established
Entrypoint
SadTalker
Direct install command
npx -y tokrepo@latest install 6393a94b-8586-11f1-9bc6-00163e2b0d79 --target codex

Run after dry-run confirms the install plan.

Introduction

SadTalker generates realistic talking head videos from a single portrait image and an audio clip. Published at CVPR 2023, it learns 3D motion coefficients to produce natural head movement and accurate lip synchronization without requiring video training data of the target person.

What SadTalker Does

  • Animates a static portrait photo using audio input
  • Generates realistic head poses and facial expressions
  • Produces accurate lip movements synchronized with speech
  • Supports both English and multilingual audio sources
  • Exports results as standard video files

Architecture Overview

SadTalker decouples the problem into two stages: ExpNet predicts 3D expression coefficients from audio, while PoseVAE generates diverse head motion sequences. These coefficients drive a 3D-aware face renderer built on a pre-trained face reconstruction network, producing temporally coherent video frames.

Self-Hosting & Configuration

  • Requires Python 3.8+ with PyTorch and CUDA support
  • Pre-trained checkpoints are downloaded automatically on first run
  • GPU with at least 6 GB VRAM recommended for smooth inference
  • Includes a Gradio web UI and a command-line interface
  • Adjustable parameters for head motion intensity and blink frequency

Key Features

  • Single-image input with no per-identity training needed
  • Realistic 3D-aware head motion beyond simple 2D warping
  • Temporally stable output with minimal flickering
  • Gradio demo for quick browser-based experimentation
  • Modular design allowing custom face renderers

Comparison with Similar Tools

  • Wav2Lip — focuses purely on lip sync; SadTalker adds head motion and expressions
  • Hallo — higher quality but heavier compute; SadTalker is faster for prototyping
  • LivePortrait — real-time capable; SadTalker offers stronger 3D motion modeling
  • MuseTalk — latent-space inpainting approach; SadTalker uses explicit 3D coefficients

FAQ

Q: What image resolution works best? A: A clear frontal portrait of at least 256x256 pixels produces good results.

Q: Can it handle non-English audio? A: Yes, since lip motion is learned from audio features rather than language-specific phonemes.

Q: Is the output suitable for production use? A: Quality is strong for prototyping and research; commercial use may require post-processing.

Q: How long does inference take? A: Roughly 1-2 minutes for a 10-second video on a mid-range GPU.

Sources

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets