README

LivePortrait: Efficient Portrait Animation with Stitching and Retargeting Control



  郭建珠 1† 
  张丁芸 1,2 
  刘晓强 1 
  钟智舟 1,3 
  张渊 1 
  万鹏飞 1 
  张迪 1 




  1 快手科技  2 中国科学技术大学  3 复旦大学 


   Equal contributions
  † Project lead






  
  
     
    
  

  
  
     
     
     
     
    
  

  
  English | 简体中文

  
  
  🔥 更多效果，请访问我们的 主页 🔥





 🔥 更新日志
- 2025/06/01：🌍 过去一年里，LivePortrait 🚀 已成为高效的人像与宠物（猫狗）动画解决方案，被快手、抖音、剪映、视频号等主流视频平台，以及众多初创公司和创作者所采用。🎉
- 2025/01/01：🐶 我们更新了一版动物模型（使用了更多动物数据），具体查看这里.
- 2024/10/18：❗ 我们更新了transformers，gradio库的版本避免安全漏洞，具体查看这里.
- 2024/08/29：📦 我们更新了Windows一键安装程序并支持自动更新, 详情建这里。
- 2024/08/19：🖼️ 我们支持了图像驱动模式和区域控制。详情请见这里。
- 2024/08/06：🎨 我们在Gradio界面支持精确的人像编辑, 受到ComfyUI-AdvancedLivePortrait启发。详见这里。
- 2024/08/05：📦 Windows用户现在可以下载一键安装程序，支持人类模式和动物模式！详情见这里。
- 2024/08/02：😸 我们发布了动物模型版本，以及其他一些更新和改进。查看详情这里！
- 2024/07/25：📦 Windows用户现在可以从 HuggingFace 或 百度云 下载软件包。解压并双击run_windows.bat即可享受！
- 2024/07/24：🎨 我们在Gradio界面支持源人像的姿势编辑。我们还降低了默认检测阈值以增加召回率。玩得开心！
- 2024/07/19：✨ 我们支持🎞️ 人像视频编辑（aka v2v）！更多信息见这里。
- 2024/07/17：🍎 我们支持macOS搭载Apple Silicon，修改来自 jeethu 的PR 143 。
- 2024/07/10：💪我们支持音频和视频拼接、驱动视频自动裁剪以及制作模板以保护隐私。更多信息见这里。
- 2024/07/09：🤗 我们发布了HuggingFace Space，感谢HF团队和Gradio！
- 2024/07/04：😊 我们发布了初始版本的推理代码和模型。持续更新，敬请关注！
- 2024/07/04：🔥 我们发布了主页和在arXiv上的技术报告。



 介绍 📖
此仓库名为LivePortrait，包含我们论文（LivePortrait: Efficient Portrait Animation with Stitching and Retargeting Control）的官方PyTorch实现。 我们正在积极更新和改进此仓库。如果您发现任何错误或有建议，欢迎提出问题或提交合并请求💖。

 上手指南 🏁
 1. 克隆代码和安装运行环境 🛠️

 [!Note]
 确保您的系统已安装git、conda和FFmpeg。有关FFmpeg安装的详细信息，见如何安装FFmpeg。

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

 使用conda创建环境
conda create -n LivePortrait python=3.10
conda activate LivePortrait


 对于Linux或Windows用户

X-Pose需要您的torch版本与CUDA版本兼容。

首先，通过以下命令检查您当前的CUDA版本：

bash
nvcc -V  example versions: 11.1, 11.8, 12.1, etc.


然后，安装相应版本的torch。以下是不同CUDA版本的示例。如果您的CUDA版本未列出，请访问PyTorch官方网站获取安装命令：
bash
 for CUDA 11.1
pip install torch==1.10.1+cu111 torchvision==0.11.2 torchaudio==0.10.1 -f https://download.pytorch.org/whl/cu111/torch_stable.html
 for CUDA 11.8
pip install torch==2.3.0 torchvision==0.18.0 torchaudio==2.3.0 --index-url https://download.pytorch.org/whl/cu118
 for CUDA 12.1
pip install torch==2.3.0 torchvision==0.18.0 torchaudio==2.3.0 --index-url https://download.pytorch.org/whl/cu121
 ...


注意：在Windows系统上，一些过高版本的CUDA(12.4、12.6等)可能会导致未知的问题，您可以考虑降低您的CUDA版本到11.8，这是我们测试的一个较为稳定的版本。降级方法可以参考 @dimitribarbot
提供的文档.

最后，安装其余依赖项：

bash
pip install -r requirements.txt


 对于搭载Apple Silicon的macOS用户

X-Pose依赖项不支持macOS，因此您可以跳过其安装。人类模式照常工作，但不支持动物模式。使用为搭载Apple Silicon的macOS提供的requirements文件：

bash
 对于搭载Apple Silicon的macOS用户
pip install -r requirements_macOS.txt


 2. 下载预训练权重(Pretrained weights) 📥

从HuggingFace下载预训练权重的最简单方法是：
bash
 !pip install -U "huggingface_hub[cli]"
huggingface-cli download KlingTeam/LivePortrait --local-dir pretrained_weights --exclude ".git" "README.md" "docs"


若您不能访问HuggingFace平台，你可以访问其镜像网站hf-