Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

LivePortrait

by Kuaishou (Kling team)

Animates a portrait photo or video with the expressions and head motion of a driving video; also supports animals.

AI presenters and avatars Open source

GitHub repoWebsite

2. Commercial use: LICENSE on GitHub

“If you want to use the LivePortrait project for commercial purposes, you should remove and replace InsightFace’s detection models to fully comply with the MIT license.”

Allowed only after removing and replacing the InsightFace detection models, which are non-commercial.

LICENSE on GitHub

License checked Nov 10, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error

LivePortrait: make a portrait photo move like a video

LivePortrait is a free, open AI model that takes one portrait photo and a short video of someone moving their face. It makes the photo copy those expressions and head moves, so a still picture turns into a short clip. It runs on your own computer with a strong graphics card or an Apple Silicon Mac, and also works for cats and dogs.

Where you can use it

Bring a still portrait to life

Take a photo or a painting of a face and a short clip of yourself making faces. You get a video where the portrait smiles, blinks and turns its head the same way.

Change expressions in a finished video

Use a talking-head video instead of a photo and give it new facial expressions from another clip, without filming again.

Make a pet photo wink or sing

Animate a photo of a cat or a dog with a person's face movements, for a fun social post or a greeting.

Reuse motion without sharing a face

Save only the movement of a clip as a small file, then use it again and again. The file does not carry the face of the person who acted it.

Edit a face by clicking in a browser

Open the local web interface to change eyes, lips or head pose of a portrait with controls instead of commands.

A friendly presenter for course intros Idea

Animate a drawn mascot or your own photo to greet viewers at the start of a lesson or product video.

As reported by Kuaishou (Kling team): The generation speed reaches 12.8ms on an RTX 4090 GPU with PyTorch.; Training data was scaled up to about 69 million frames..

LivePortrait popularity

40 / 100
Gid Score, same scale as developer tools
19,530
GitHub stars
LivePortrait: GitHub starsKlingAIResearch/LivePortrait 19,530

How the Gid Score is calculated

How to start

Tell your AI assistant

“Set up LivePortrait from github.com/KlingTeam/LivePortrait in a conda env with Python 3.10, download the weights with huggingface-cli into pretrained_weights, run python inference.py with my photo as -s and my clip as -d, and do not use it for anything commercial until the InsightFace detection models are replaced.”

Show codeStep 1 or Step 2 or Step 3

Get the code and make a Python 3.10 environment. Git, conda and FFmpeg must already be installed.

git clone https://github.com/KlingTeam/LivePortrait
cd LivePortrait

# create env using conda
conda create -n LivePortrait python=3.10
conda activate LivePortrait

Mistakes to avoid

shipping the default pipeline in a paid app or client project
replace the InsightFace detection models (buffalo_l) with a commercially usable face detector first

The InsightFace models are non-commercial research only, even though the LivePortrait code is MIT.

python inference.py on an Apple Silicon Mac without the fallback flag
PYTORCH_ENABLE_MPS_FALLBACK=1 python inference.py

The README gives this environment variable for Apple Silicon runs.

using a wide, uncropped driving video with lots of shoulder movement
crop it to 1:1 around the head, or add --flag_crop_driving_video

The authors recommend a square head crop with little shoulder movement.

accepting a result with a black box over the face
run again with --no_flag_use_half_precision

Half precision causes the black box problem on some machines.

python app.py --flag_do_torch_compile on Windows or macOS
use plain python app.py there; the compile speed-up is for Linux with NVIDIA

The README says this option is not supported on Windows and macOS.

License

MIT (bundled InsightFace models non-commercial) license. The LivePortrait code and models are under the MIT license. The face detection models it ships with, from InsightFace, are for non-commercial research only, so swap them before any paid use.

Commercial use
With conditions

“If you want to use the LivePortrait project for commercial purposes, you should remove and replace InsightFace’s detection models to fully comply with the MIT license.” LICENSE on GitHub

Credit
Not stated
Inside your app or game
With conditions

“The models of InsightFace are for non-commercial research purposes only.” LICENSE on GitHub

Pass the files on to your users
With conditions

Code and LivePortrait weights may be passed on with the MIT notice; InsightFace models only for non-commercial research.

“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” LICENSE on GitHub

Monetized YouTube
With conditions

“If you want to use the LivePortrait project for commercial purposes, you should remove and replace InsightFace’s detection models to fully comply with the MIT license.” LICENSE on GitHub

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is LivePortrait free for commercial use? The full answer Not legal advice. Check the license page before you ship.

For your agent

License rules tell your agent what it may do with LivePortrait. Paste them into your prompt or AGENTS.md.

License rules
- LivePortrait (AI presenters and avatars). Animates a portrait photo or video with the expressions and head motion of a driving video; also supports animals. Price: free; commercial use with conditions; ship inside your app with conditions.
  Connect: download from https://huggingface.co/KlingTeam/LivePortrait (no API).
  Rule: LivePortrait code and weights are MIT; keep the copyright notice in copies.
  Rule: The bundled InsightFace face-detection models are non-commercial; replace them before any commercial use.
  License: https://github.com/KlingAIResearch/LivePortrait/blob/main/LICENSE (checked 2026-11-10; details: https://agentgid.com/assets/liveportrait/)
Can an agent use it by itself?
No.
API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Portrait animation: LivePortrait (Kuaishou), MIT License
This card for machines

Alternatives

LivePortrait This page

Free With conditions Download

SoulX-FlashTalk

Pick SoulX-FlashTalk when the face should move from a voice recording, as a talking avatar, instead of copying a video.

Free Commercial OK Download

HeyGen

Pick HeyGen when you want finished avatar videos from a hosted service and are fine paying per minute.

Free tier With conditions MCP, API, npm

VOCA (Voice Operated Character Animation)

Pick VOCA when you need speech-driven face movement for a 3D head model, not a photo.

Free Non-commercial Download

Synthesia

AI avatar video platform with an API and MCP; free videos carry a watermark.

Free tier With conditions MCP, API

Vidyard

Video hosting and messaging platform with AI avatar presenters, personalized video generation and analytics for sales teams.

Free tier With conditions MCP

All ai presenters and avatars

Questions

Can I use LivePortrait in a paid product?

Only after you replace the InsightFace face detection models, which are for non-commercial research only. The rest is under the MIT license.

Does it work on a Mac?

Yes for people on Apple Silicon, but slower; the animal mode is not supported on a Mac.

Can a photo drive another photo, not only a video?

Yes. You can give an image as the motion source and limit the change to lips, eyes, pose or expression.

Does the sound of my motion clip stay?

Yes. If the driving video has sound, it is added to the result, at the same frame rate.

AgentGid articles about LivePortrait

All guides