Skip to content
SPECIFICTION
Get listed

LivePortrait

liveportrait.github.io

WebWindowsmacOSLinuxSelf-hosted

What it is

LivePortrait creates portrait video from a single image, using motion from video, audio, text, or generation. It also supports editing portrait video using a source video and a driving video. Stitching and eye and lip retargeting controls provide ways to adjust animation. The project supplies inference code, pretrained models, and a Gradio interface for local use, as well as a demo hosted on Hugging Face Spaces. Its PyTorch implementation is released under the MIT License, and the project reports generation speed of 12.8 ms on an RTX 4090 GPU with PyTorch. Human-mode instructions cover Linux, Windows, and Apple Silicon macOS; Intel macOS is untested. Animal models can animate cats, dogs, and pandas using human-driven motion, but animal mode is tested only on Linux and Windows with an NVIDIA GPU and is unsupported on macOS. Local setup requires git, conda, FFmpeg, Python 3.10, and downloaded pretrained weights. Commercial users must replace the included InsightFace detection models. Maintainers warn of possible deepfake misuse and visual artifacts.

Spec sheet

Purpose
LivePortrait animates a portrait from a still image using facial expressions and head pose from a driving video, audio, text, or generated motion.Read 2 Oct 2026 · liveportrait.github.io
integrations
Community resources include FaceFusion, ComfyUI nodes, a Stable Diffusion WebUI extension, Replicate, FAL, Poe, and Hugging Face Spaces.Read 30 Sep 2026 · github.com
Security
The maintainers report updating the Transformers and Gradio library versions in October 2024 to avoid security vulnerabilities.Read 2 Oct 2026 · github.com
Privacy
The repository says generated motion template files can speed inference and protect privacy.Read 2 Oct 2026 · github.com
Support
The maintainers invite bug reports and suggestions through repository issues and pull requests and provide a contact email for project inquiries.Read 2 Oct 2026 · github.com
Animal animation
An animal model can animate cats, dogs, and pandas using human-driven motion.Read 2 Oct 2026 · liveportrait.github.io
animal limitation
Animals mode is only tested on Linux and Windows with an NVIDIA GPU and is unsupported on macOS because X-Pose does not support macOS.Read 30 Sep 2026 · github.com
animal support
Fine-tuned models can animate cats, dogs, and pandas using human driving motion.Read 30 Sep 2026 · liveportrait.github.io
Animation controls
The project includes stitching and eye and lip retargeting controls for portrait animation.Read 2 Oct 2026 · liveportrait.github.io
commercial licensing
InsightFace models included in the project are for non-commercial research, and commercial users must replace those detection models.Read 30 Sep 2026 · github.com
Community integrations
The repository lists community-developed ComfyUI nodes, a Stable Diffusion WebUI extension, and FaceFusion processors that use LivePortrait.Read 2 Oct 2026 · github.com
controls
The system includes stitching and eye/lip retargeting modules for improved controllability.Read 30 Sep 2026 · liveportrait.github.io
Ethics
The maintainers warn about deepfake misuse, note that generated results may contain visual artifacts, and disclaim legal responsibility for use of generated results.Read 2 Oct 2026 · github.com
Hardware limits
The repository says animal mode is tested only on Linux and Windows with an NVIDIA GPU, and is unsupported on macOS because its X-Pose dependency does not support macOS.Read 2 Oct 2026 · github.com
License and commercial use
The repository includes an MIT license but says commercial users must remove and replace InsightFace detection models to comply with that license.Read 2 Oct 2026 · github.com
local setup
The project requires git, conda, FFmpeg, Python 3.10, and downloaded pretrained weights.Read 30 Sep 2026 · github.com
Local use
The repository provides inference code, pretrained models, and a Gradio interface for local use.Read 2 Oct 2026 · github.com
open source
The official implementation is provided as a PyTorch repository and is released under the MIT License.Read 30 Sep 2026 · github.com
Performance
The project reports generation speed of 12.8 ms on an RTX 4090 GPU with PyTorch.Read 2 Oct 2026 · liveportrait.github.io
platform support
Humans mode supports Linux, Windows, and macOS with Apple Silicon; Intel macOS is not tested.Read 30 Sep 2026 · github.com
risk notice
The maintainers warn that portrait animation can be misused for deepfakes and state that they assume no legal responsibility for generated results.Read 30 Sep 2026 · github.com
security updates
The maintainers updated the transformers and gradio versions to avoid security vulnerabilities.Read 30 Sep 2026 · github.com
speed
Generation speed reaches 12.8 ms on an RTX 4090 GPU with PyTorch.Read 30 Sep 2026 · liveportrait.github.io
Supported systems
The repository documents human-mode use on Linux and Windows and on Apple Silicon macOS; Intel macOS is untested or unsupported in the stated instructions.Read 2 Oct 2026 · github.com
Video editing
The project supports portrait video editing using a source video and a driving video.Read 2 Oct 2026 · github.com
web access
The project provides an online demo through Hugging Face Spaces.Read 30 Sep 2026 · github.com
Web demo
The maintainers link to a LivePortrait demo hosted on Hugging Face Spaces.Read 2 Oct 2026 · github.com

Strong points and limits

Strong points

  • Accepts motion from video, audio, or text
  • Includes eye and lip retargeting controls
  • Provides local inference code and a web demo
  • Released under the MIT License

Limits

  • Local setup requires several tools and pretrained weights
  • Intel macOS is untested
  • Animal mode is unsupported on macOS
  • Commercial users must replace InsightFace detection models

Who it suits

LivePortrait suits people who want to generate or edit portrait animation and are comfortable with local setup or an online demo. Animal animation is for users on supported Linux or Windows systems with an NVIDIA GPU.

LivePortrait in depth

Read the full write-up

LivePortrait turns still portraits into motion-led videos and suits technically confident creators who want local control over facial animation. Its flexibility and free MIT-licensed implementation are strong draws, but setup takes several dependencies and commercial users must replace the included InsightFace detection models.

Overview

LivePortrait can animate a source image from a driving video, audio, text, or generation, and can edit portrait video by combining a source video with a driving video. It focuses on face animation rather than depth effects, with MP4 as its stated export format.

The project provides local inference code, pretrained weights, and a Gradio interface, as well as an online demo hosted on Hugging Face Spaces. Running it locally requires Git, conda, FFmpeg, Python 3.10, and downloaded pretrained weights, so it is a better fit for users comfortable with an AI project setup than for those seeking a turnkey editor.

Portrait animation can produce visual artifacts and can be misused to create deepfakes. The maintainers disclaim legal responsibility for generated results; consent and intended use warrant care.

Key features

Multiple motion inputs: Driving video, audio, text, or generation can supply motion for a still portrait. That range makes the project useful for varied animation workflows, while its source-video plus driving-video mode also supports portrait video editing.

Facial controls: Stitching and eye- and lip-retargeting modules give users more control over the result than a single-pass animation workflow.

Animal animation: Fine-tuned models can animate cats, dogs, and pandas from human driving motion. This broadens the creative use case, but the mode has narrower hardware and platform support than human animation.

Reported speed: The project reports generation at 12.8 ms on an RTX 4090 GPU with PyTorch. That is a useful performance reference for that hardware, not a guarantee for other systems.

Privacy option: Motion templates can speed inference and protect privacy, which may suit workflows where sharing a driving video is undesirable.

Pricing

LivePortrait is free and open source under the MIT License, with no paid plan described. The trade-off is that free access does not remove setup work: users need the required software dependencies and pretrained weights, and local performance depends on their hardware.

The commercial-use condition matters. InsightFace detection models included in the project are for non-commercial research; commercial users must remove and replace those models to comply with their license. The project’s MIT license does not eliminate that separate requirement.

Platforms

Human mode supports Linux, Windows, and macOS on Apple Silicon. Intel macOS is not tested in the stated instructions, so users on those machines should not assume the same compatibility.

Animal mode is tested only on Linux and Windows with an NVIDIA GPU. It is unsupported on macOS because its X-Pose dependency does not support that platform. The hosted Hugging Face Spaces demo provides a web route to try LivePortrait without setting up the local repository, while the project itself offers a self-hosted workflow.

Who it's for

LivePortrait suits developers, technically confident creators, and researchers who want a free local portrait-animation system with multiple motion inputs and retargeting controls. Its animal models are a particular draw for Linux or Windows users with an NVIDIA GPU. It is less suitable for someone who needs a polished, low-setup commercial service or a supported animal workflow on macOS.

Pros and cons

Pro: Free, MIT-licensed code and local inference make it possible to build a portrait-animation workflow without a paid plan.

Pro: Video, audio, text, and generated motion, plus stitching and eye/lip retargeting, offer meaningful control over facial animation.

Pro: Fine-tuned cat, dog, and panda models extend the project beyond human portraits.

Con: Local setup requires several tools, Python 3.10, and separate pretrained weights, creating friction for nontechnical users.

Con: Animal animation excludes macOS and requires an NVIDIA GPU on its supported Linux and Windows configurations.

Con: Commercial users must replace the included InsightFace detection models, adding a licensing and implementation step.

Con: The maintainers warn of visual artifacts and deepfake misuse, so outputs may need scrutiny and responsible handling.

Alternatives

For a hosted option with a stated free monthly video allowance, consider HeyGen: its free plan includes up to three videos per month, each no longer than one minute, across web, Android, iOS, and API. Pika is another freemium web, iOS, and API option, though its free plan has zero monthly credits and uses packs instead.

Hedra may suit users who prefer monthly credit plans and commercial use: Basic costs $20 a month for 2,000 credits, while Pro costs $50 a month for 7,200 credits. For a text-to-video, image-to-video, or reference-based world-generation model, consider Vidu.

Animate Photo AI offers a web-based free tier with 50 credits, which may be preferable for a browser-first workflow. AnimateDiff is a free, self-hosted alternative released for academic use. For one-time credit packs or a monthly paid plan, AnimatePhoto is another web option. Animate Old Photos may fit users seeking a paid service with a 7-day cloud history and one-time credit packs.

For more options, browse AI Photo Animation Tools and Photo Animation Software.

Verdict

Choose LivePortrait if you want free, locally runnable portrait animation with flexible motion inputs and facial retargeting, and you can manage its dependencies and licensing conditions. Look elsewhere if you need a simpler hosted workflow, dependable Intel Mac support, or animal animation on macOS.

Verdict

LivePortrait offers local portrait animation, editing controls, and a hosted demo, with distinct platform limits for human and animal modes. Commercial use requires replacing the included InsightFace detection models.

Where Specifiction places it

Alternatives to LivePortraitAll alternatives →