Skip to main content

LivePortrait

This document explains how to run the LivePortrait example application on a host device equipped with the Radxa AICore AX-M1.

Precompiled model quantization methods: w8a16

Download Example Application Repository​

Download the example application repository using huggingfcae-cli.

Host
pip3 install -U "huggingface_hub[cli]"
huggingface-cli download AXERA-TECH/LivePortrait --local-dir ./LivePortrait
cd LivePortrait

Example Usage​

Install System Dependencies​

Host
sudo apt install ffmpeg

Install Python Dependencies​

Host
pip install -r python/requirements.txt
pip3 install https://github.com/AXERA-TECH/pyaxengine/releases/download/0.1.3.rc1/axengine-0.1.3-py3-none-any.whl

Model Inference​

Host
python3 ./python/infer.py --source ./assets/examples/source/s0.jpg --driving ./assets/examples/driving/d8.jpg --models ./python/axmodels/ --output-dir ./axmodel_infer
(.venv) rock@rock-5b-plus:~/ssd/axera/LivePortrait$ python3 ./python/infer.py --source ./assets/examples/source/s0.jpg --driving ./assets/examples/driving/d8.jpg --models ./python/axmodels/ --output-dir ./axmodel_infer
[INFO] Available providers:  ['AXCLRTExecutionProvider']
[INFO] Using provider: AXCLRTExecutionProvider
[INFO] SOC Name: AX650N
[INFO] VNPU type: VNPUType.DISABLED
[INFO] Compiler version: 3.3 144960ad
[INFO] Using provider: AXCLRTExecutionProvider
[INFO] SOC Name: AX650N
[INFO] VNPU type: VNPUType.DISABLED
[INFO] Compiler version: 3.3 144960ad
[INFO] Using provider: AXCLRTExecutionProvider
[INFO] SOC Name: AX650N
[INFO] VNPU type: VNPUType.DISABLED
[INFO] Compiler version: 3.3 0f7260e8
[INFO] Using provider: AXCLRTExecutionProvider
[INFO] SOC Name: AX650N
[INFO] VNPU type: VNPUType.DISABLED
[INFO] Compiler version: 3.3 144960ad
FaceAnalysisDIY warmup time: 0.391s
[03:10:43] LandmarkRunner warmup time: 0.156s                                                                    human_landmark_runner.py:95
2025-07-24 03:10:43.584 | INFO     | __main__:main:727 - Start making driving motion template...
/mnt/ssd/axera/LivePortrait/python/utils/dependencies/insightface/utils/transform.py:68: FutureWarning: `rcond` parameter will change to the default of machine precision times ``max(M, N)`` where M and N are the input matrix dimensions.
To use the future default and silence this warning we advise to pass `rcond=None`, to keep using the old, explicitly pass `rcond=-1`.
  P = np.linalg.lstsq(X_homo, Y)[0].T # Affine matrix. 3 x 4
2025-07-24 03:10:44.898 | INFO     | __main__:main:747 - Prepared pasteback mask done.
2025-07-24 03:10:46.240 | INFO     | __main__:main:787 - The output of image-driven portrait animation is an image.
2025-07-24 03:10:55.345 | DEBUG    | __main__:warp_decode:647 - warp time: 9.102s
2025-07-24 03:10:55.639 | INFO     | __main__:main:881 - Animated image: ./axmodel_infer/s0--d8.jpg
2025-07-24 03:10:55.639 | INFO     | __main__:main:882 - Animated image with concat: ./axmodel_infer/s0--d8_concat.jpg
2025-07-24 03:10:55.684 | DEBUG    | __main__:<module>:894 - LivePortrait axmodel infer time: 16.407s

liveportrait demo output