Practical overview
When it fits
Use the demo when you have a suitable source image, driving video, task-specific configuration and checkpoint, and want to generate an animation locally. Use the training or evaluation code when working with a dataset and model checkpoints.
Who it is for
- Researchers studying image animation and motion transfer.
- Developers building or adapting image-animation workflows.
- Users who can prepare cropped image and video inputs and run Python code.
Documented uses
- Animate an object in a still source image using motion from a driving video.
- Train a model on a specific dataset and save checkpoints.
- Generate video reconstructions or animate test-set examples for evaluation.
Requirements & limits
The implementation is publicly available on GitHub under an MIT license. The repository links to a Colab notebook and a Hugging Face Space as additional demo entry points.
- Both source image and driving video should be cropped before use.
- Configurations and separately trained networks are associated with different tasks; choose the matching configuration and checkpoint.
- The documented local setup uses Python 3 and the dependencies in
requirements.txt. - The Linux Docker option specifies Docker 19.03 or later and nvidia-docker.
- The repository does not document a general-purpose API.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the image-animation demo
Use a pretrained checkpoint, source image and driving video with the repository's documented demo command.
Before you start
- Python 3 and dependencies installed with
pip install -r requirements.txt. - A dataset YAML configuration, pretrained checkpoint, source image and driving video.
- Cropped source image and driving video.
Steps
Install the repository dependencies with the command below.
pip install -r requirements.txtObtain a pretrained checkpoint and choose a configuration file for the dataset.
Run the command below.
python demo.py --config config/dataset_name.yaml --driving_video path/to/driving --source_image path/to/source --checkpoint path/to/checkpoint --relative --adapt_scaleRetrieve the generated
result.mp4.
Expected outcome
The demo writes an animated result to `result.mp4`, transferring motion from the driving video to the object in the source image.
Guide limitations
- The README requires cropped inputs but does not specify a universal cropping method.
- The project describes separate networks for different tasks; configuration and checkpoint selection depend on the task.
- The README's crop-suggestion script requires the face-alignment library.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- AliaksandrSiarohin/first-order-model · Official homepage title · retained in its source language

