如何零基础玩转LivePortrait：3步全平台部署人像动画工具

如何零基础玩转LivePortrait：3步全平台部署人像动画工具

【免费下载链接】LivePortraitBring portraits to life!项目地址: https://gitcode.com/GitHub_Trending/li/LivePortrait

人像动画工具LivePortrait凭借高效的肖像动画生成能力，已成为短视频创作、数字营销等领域的必备工具。本文将通过环境诊断、分步实施、场景应用和进阶技巧四个模块，帮助你快速完成Windows/macOS/Linux全平台部署，让静态肖像即刻"活"起来。

一、环境诊断：3步完成系统兼容性校验

在开始部署前，请确保你的设备满足以下条件：

1.1 硬件要求检查

• 推荐配置：NVIDIA显卡（≥4GB显存）或Apple Silicon芯片
• 最低配置：8GB内存+支持OpenCL的集成显卡

1.2 必备软件安装

📌 提示：Conda用户可直接执行conda install ffmpeg完成跨平台安装

1.3 网络环境准备

确保能够访问Git和模型下载源，国内用户建议配置镜像加速：

export HF_ENDPOINT=https://hf-mirror.com

二、分步实施：5分钟极速部署流程

2.1 获取项目代码

git clone https://gitcode.com/GitHub_Trending/li/LivePortrait cd LivePortrait

2.2 创建虚拟环境

conda create -n LivePortrait python=3.10 -y conda activate LivePortrait

2.3 安装依赖包

• Windows/Linux（CUDA）：

  # 查看CUDA版本：nvcc -V pip install torch==2.3.0 torchvision==0.18.0 --index-url https://download.pytorch.org/whl/cu118 pip install -r requirements.txt

• macOS（Apple Silicon）：

  pip install -r requirements_macOS.txt

2.4 下载预训练模型

pip install -U "huggingface_hub[cli]" huggingface-cli download KwaiVGI/LivePortrait --local-dir pretrained_weights --exclude "*.git*" "README.md" "docs"

🔧 安装避坑：若模型下载失败，可手动下载后解压至pretrained_weights目录，目录结构需符合assets/docs/directory-structure.md规范

三、场景应用：从命令行到界面的全方位体验

3.1 命令行快速推理

• 人类肖像动画：

  # Windows/Linux python inference.py # macOS PYTORCH_ENABLE_MPS_FALLBACK=1 python inference.py

• 动物肖像动画（仅Windows/Linux）：

  # 构建MultiScaleDeformableAttention组件 cd src/utils/dependencies/XPose/models/UniPose/ops python setup.py build install cd - # 运行推理 python inference_animals.py -s assets/examples/source/s39.jpg -d assets/examples/driving/wink.pkl --driving_multiplier 1.75

3.2 图形界面操作

启动Gradio可视化界面，通过直观操作生成动画：

# 人类模式 python app.py # 动物模式 python app_animals.py

图：LivePortrait图形界面，支持拖拽上传和参数调节

四、进阶技巧：性能调优与功能扩展

4.1 性能测试与优化

运行速度测试脚本了解设备性能：

python speed.py

测试结果参考assets/docs/speed.md中的优化建议

4.2 姿势编辑功能

通过Gradio界面的"Retargeting"功能调整肖像姿势和表情：

图：通过滑动条精确控制眼睛开合度、头部姿态等参数

4.3 动物模式高级应用

动物模型支持更丰富的表情控制，上传动物图片后可调整驱动参数获得最佳效果：

图：动物肖像动画生成界面，支持多种驱动方式

结语

通过本文的步骤，你已掌握LivePortrait的全平台部署方法和核心功能应用。项目持续更新中，定期执行git pull可获取最新特性。如有问题，可查阅官方文档或提交Issue获取支持。现在，开始你的肖像动画创作之旅吧！

【免费下载链接】LivePortraitBring portraits to life!项目地址: https://gitcode.com/GitHub_Trending/li/LivePortrait