LivePortraitby KlingAIResearch
LivePortrait animates still portrait images using motion drivers from a video source via PyTorch. It's also a popular Free Alternative to HeyGen / D-ID for creators who don't want to pay a monthly subscription.
What Is LivePortrait?
New to GitHub repos? Here's what this actually does, in plain language:
Bhai, if you want to animate old photos or static portraits using a driving video without paying high cloud subscription fees, this open-source Python repo is totally worth setting up.
Strengths, Limitations & Is It Safe to Install?
An honest breakdown before you install anything on your PC:
โ What It Does Well
- Incredible motion transfer accuracy for eyes, lips, and subtle head tilts
- Completely free to run locally without per-minute cloud rendering costs
- Active open-source community providing WebUI wrappers and extensions
โ What It Can't Do / Limitations
- Requires a dedicated Nvidia GPU with at least 8GB VRAM for smooth local generation
- Command-line setup has a steep learning curve for absolute beginners
- Can produce uncanny valley artifacts or stretching if the driving video is too extreme
๐ก๏ธ Is It Safe to Install?
The repository code itself is safe to install from GitHub, but because this tool generates hyper-realistic deepfake facial animations from single photos, you must obtain explicit consent from individuals before animating their likeness to avoid legal and ethical violations.
Hardware & PC System Requirements
Check if your laptop / PC can run LivePortrait smoothly:
โก 1-Click Setup Commands for LivePortrait
Copy & paste in Terminal or Command Prompt:git clone https://github.com/KlingAIResearch/LivePortrait.gitWant 50+ DaVinci Resolve & Filmmaking tutorials?
Beginner Installation Guide (Windows & Mac)
Straightforward step-by-step installation instructions for Windows and macOS systems:
๐ป Windows Install Steps:
- Step 1: Press
Win + Rkeys together, typecmdand hit Enter to open Command Prompt. - Step 2: Copy the
git clone https://github.com/KlingAIResearch/LivePortrait.gitcommand from the top banner. - Step 3: Right-click in Command Prompt to paste the command and press Enter. Installation complete!
๐ Mac Install Steps (Apple Silicon & Intel):
- Step 1: Press
Cmd + Space, typeTerminaland hit Enter. - Step 2: Copy the
git clone https://github.com/KlingAIResearch/LivePortrait.gitcommand from the top banner. - Step 3: Paste into Terminal and press Enter. If Mac blocks opening: Go to System Settings > Privacy & Security > Click "Open Anyway".
How to Use LivePortrait (Beginner Quick Start Tutorial)
First time launching this application? Follow our beginner operational workflow:
Clone the Repository
Download the project files from GitHub to your local machine.
git clone https://github.com/KlingAIResearch/LivePortrait.gitInstall Dependencies
Set up a virtual environment and install the required Python packages.
pip install -r requirements.txtDownload Pretrained Weights
Fetch the official model checkpoint weights and place them in the designated assets folder.
Run the Inference Script
Execute the main Python script passing your target portrait and driving video paths.
python inference.py --source path/to/image.jpg --driving path/to/video.mp4Troubleshooting & Fix Common Errors
If you encounter unexpected errors or installation failures, apply these verified diagnostic fixes:
Root Cause: Your GPU VRAM is full because the AI model batch size or resolution is too high.
Root Cause: The required software is installed but not added to your Windows Environment System PATH.
Root Cause: Installed PyTorch binary does not match your Nvidia GPU CUDA driver version.
Root Cause: Another WebUI or Python background process is already running on the default local port.
๐ก Why LivePortrait is the Best Free Alternative to HeyGen / D-ID
Bhai, if you want to animate old photos or static portraits using a driving video without paying high cloud subscription fees, this open-source Python repo is totally worth setting up.
If you are tired of expensive monthly subscription fees and privacy concerns, LivePortrait offers a completely free, open-source alternative. Running 100% locally on your computer (Windows, Mac, or Linux), it delivers high performance without export limits or cloud dependencies.
๐ Comparison: LivePortrait vs Free Alternative to HeyGen / D-ID
| Feature / Metric | LivePortrait (Free Open-Source) | Free Alternative to HeyGen / D-ID (Paid) |
|---|---|---|
| Pricing Model | 100% Free Forever (โน0) | Paid Monthly Subscription |
| Data Privacy & Security | 100% Offline Local Computer | Cloud Server Upload Required |
| System Control | Full Source Code & Custom Scripts | Restricted Closed Code |
| Community Extensions | Unlimited GitHub Plugins | Limited Official Marketplace |
Want the Top 50 Open-Source Tools PDF Cheatsheet?
Get 1-click install scripts for yt-dlp, Whisper, UVR5, ComfyUI sent to your email.
๐ Source Code & Official Links
Finished reading the guide? You can inspect the source code or star the repository directly on GitHub below:
๐ฅ Related Open-Source Tools
AUTOMATIC1111 SD WebUI
Stable Diffusion browser interface for AI image generation, inpainting, face swapping, and controlnet.
View Guide โโ 133.6k starsComfyUI
The most powerful visual node-based GUI for Stable Diffusion & AI Video generation.
View Guide โโ 53.1k starsFooocus AI
Image generation software automating prompt weighting & quality tuning like Midjourney.
View Guide โ