Practical overview
When it fits
Use it when you have or can generate a character portrait and an audio track, and want to explore a SadTalker-based workflow for producing a talking-head clip.
Who it is for
- Creators prototyping animated character portraits.
- Game-asset makers preparing talking character clips.
- Developers exploring portrait-to-video workflows with generated speech.
Documented uses
- Turn a portrait image and speech audio into a talking-head video.
- Generate speech audio from text through the described ElevenLabs workflow.
- Create a full-body video variant using the documented still and full-preprocessing options.
Requirements & limits
The project is published as a public GitHub repository under the MIT license.
- The README documents a local Linux setup with Python 3.8, Conda, FFmpeg, listed CUDA 11.3 PyTorch packages, and downloaded model files.
- Leonardo.ai and ElevenLabs are named as external image-generation and text-to-speech services.
- Manual inference accepts audio and image inputs and saves MP4 output; the README also provides a distinct full-body still-mode example.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the Linux environment and model files
Prepare the documented Python environment and download trained models before using the inference workflow.
Before you start
- Linux
- Anaconda, Python, and Git
- CUDA 11.3-compatible PyTorch packages as listed in the README
Steps
Clone the repository and change to the project directory.
Create and activate a Conda environment with Python 3.8.
Install the listed PyTorch, torchvision, and torchaudio packages, then install FFmpeg and the requirements file.
Run the model-download script to place the trained models in the expected folders.
Expected outcome
A configured environment with the project requirements and downloaded model files.
Guide limitations
- The README does not provide a complete local runtime specification beyond the listed setup instructions.
- The optional TTS package is described as optional for the Gradio demo; the setup steps do not explain how to connect external API credentials.
Generate a talking-head video from image and audio files
Use the documented manual inference command to create an MP4 from a source image and a driving audio file.
Before you start
- The configured project environment and downloaded model files
- A driving audio file and a source image
Steps
Provide the audio file with the --driven_audio argument.
Provide the portrait image with the --source_image argument.
Optionally add the documented GFPGAN enhancer argument and run inference.py.
Expected outcome
The README says results are saved as MP4 files under a timestamped results directory.
Guide limitations
- The README documents a separate still-mode command for full-body output; that mode requires additional options.
- The instructions do not specify API-key setup or a complete configuration procedure for Leonardo.ai or ElevenLabs.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- Yazdi9/Talking_Face_Avatar · Official homepage title · retained in its source language

