Practical overview
When it fits
Use the manual poser for direct graphical adjustments to a character. Use the puppeteer when facial-motion transfer is the goal and the required iOS device and companion app are available.
Who it is for
- Anime character creators who want to adjust expression and pose from one reference image.
- Users who want to transfer their facial motion to an anime character.
Documented uses
- Adjust facial expression, head rotation, body rotation and breathing-related chest expansion.
- Transfer a person's facial motion to an anime character.
Requirements & limits
The manual poser is also offered through a Google Colab notebook. The iFacialMocap app is identified in the README as a paid App Store purchase.
- Both desktop programs require a recent, powerful Nvidia GPU and a CUDA-enabled Python environment.
- The puppeteer additionally requires an iOS 11-or-later device with a TrueDepth front-facing camera, iFacialMocap, and a shared network between phone and computer.
- The README lists Python, PyTorch, SciPy, wxPython and Matplotlib requirements and notes that versions may need adjustment.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Prepare the local Python environment and model files
Set up the documented prerequisites for the desktop demo programs.
Before you start
- A recent, powerful Nvidia GPU with an updated driver
- A compatible CUDA toolkit
- Python 3.8 or later, PyTorch with CUDA support, SciPy, wxPython and Matplotlib
- The repository and its model files
Steps
Create a Python environment using the listed package requirements, or use Anaconda with the repository's environment.yml file.
Download the model files and unzip them into the repository's data/models folder.
Adjust Python and CUDA versions as needed for the operating system and available PyTorch build.
Expected outcome
The Python environment and model-file locations are prepared for the demo programs.
Guide limitations
- A recent, powerful Nvidia GPU is required to run either desktop program.
- The README cautions against Python 3.10 with wxPython on Windows.
- This recipe covers setup prerequisites, not running or verifying the programs.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- pkhungurn/talking-head-anime-3-demo · Official homepage title · retained in its source language

