3步搞定AI肖像动画工具LivePortrait：跨平台安装部署指南

3步搞定AI肖像动画工具LivePortrait：跨平台安装部署指南

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

LivePortrait作为一款高效的AI肖像动画解决方案，已被广泛应用于内容创作领域。本指南将带你通过环境准备、核心安装、功能探索和进阶优化四个阶段，快速部署这套人像动画工具，让静态肖像"活"起来！

环境准备：系统适配方案

硬件要求

必备软件安装

FFmpeg音视频处理工具

🪟Windows用户
下载ffmpeg.exe和ffprobe.exe，放置到项目根目录

🍎macOS用户

brew install ffmpeg

🐧Linux用户

sudo apt install ffmpeg sudo apt install libsox-dev conda install -c conda-forge 'ffmpeg<7'

Git与Conda安装

• Git: 从官网下载并安装
• Conda: 推荐Miniconda，选择Python 3.10版本

✅环境验证步骤
打开终端执行以下命令，确认所有工具已正确安装：

git --version conda --version ffmpeg -version

核心安装：模型部署技巧

1. 获取项目代码

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

2. 创建虚拟环境

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

3. 安装依赖包

🪟Windows/Linux用户
先检查CUDA版本：

nvcc -V # 查看CUDA版本

根据CUDA版本安装对应PyTorch：

# 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 # 安装其余依赖 pip install -r requirements.txt

🍎macOS用户（Apple Silicon）

pip install -r requirements_macOS.txt

4. 下载预训练模型

# 安装huggingface_hub pip install -U "huggingface_hub[cli]" # 国内用户建议使用镜像 export HF_ENDPOINT=https://hf-mirror.com # 下载模型 huggingface-cli download KwaiVGI/LivePortrait --local-dir pretrained_weights --exclude "*.git*" "README.md" "docs"

✅安装验证步骤
检查pretrained_weights目录是否包含模型文件，执行以下命令验证环境：

python -c "import torch; print('PyTorch版本:', torch.__version__)" python -c "import cv2; print('OpenCV版本:', cv2.__version__)"

功能探索：界面与基础操作

启动图形界面

人类模式

python app.py

动物模式

仅支持Windows/Linux，需先构建专用组件：

# 构建MultiScaleDeformableAttention cd src/utils/dependencies/XPose/models/UniPose/ops python setup.py build install cd - # 运行动物模型 python app_animals.py

启动后会自动打开浏览器，显示Gradio界面：

基础操作流程

1. 上传源图/视频：在左侧面板上传静态肖像或视频
2. 选择驱动文件：在右侧面板选择动作驱动视频或预设动作
3. 调整参数：根据需要调整裁剪比例、动作强度等参数
4. 生成动画：点击"Animate"按钮开始生成，结果会显示在下方面板

特色功能体验

姿势编辑功能

通过调整滑块精确控制肖像的表情和姿态：

视频重定向功能

将一个视频的动作迁移到另一个视频主体上：

动物模式

专门针对动物肖像的动画生成功能：

✅功能验证步骤
尝试使用示例图片生成动画：

python inference.py -s assets/examples/source/s9.jpg -d assets/examples/driving/d0.mp4

检查animations目录是否生成结果文件

进阶优化：性能调优与问题解决

性能优化参数对照表

常见错误速查

性能测试

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

python speed.py

社区资源导航

• 项目文档：assets/docs目录下包含详细使用说明
• 示例文件：assets/examples目录提供多种测试素材
• 更新日志：assets/docs/changelog目录记录版本更新
• 问题反馈：通过项目Issues页面提交bug和建议

💡小贴士：定期执行git pull获取最新功能和修复，保持软件处于最新状态。

⚠️注意事项：动物模型功能目前仅支持Windows和Linux系统，macOS用户暂时无法使用该特性。

通过以上步骤，你已成功部署并开始使用LivePortrait人像动画工具。无论是制作生动的社交内容，还是开发创意视频项目，这套工具都能为你提供强大的AI动画生成能力。

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