AdvancedLivePortrait-WebUI

这是一个基于 Gradio 的 WebUI，源自 LivePortrait 和 ComfyUI-AdvancedLivePortrait。
您可以编辑图像中的面部表情。

https://github.com/user-attachments/assets/9946a969-599b-4fca-8d83-7915cb7c4a00

Notebook

您可以在 Colab 中试用

安装与运行

前提条件

1. 3.9 <= python <= 3.12 : https://www.python.org/downloads/release/python-3110/
2. （可选，仅在使用 Nvidia GPU 时） CUDA 12.4 : https://developer.nvidia.com/cuda-12-4-0-download-archive?target_os=Windows
3. （可选，仅在使用视频驱动时需要）FFmpeg：https://ffmpeg.org/download.html
   安装 FFmpeg 后，请务必将 FFmpeg/bin 文件夹添加到您的系统 PATH！

本地运行

1. 克隆此仓库

git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git

2. 安装依赖（如果您不使用 Nvidia GPU，请使用 requirements-cpu.txt。）

pip install -r requirements.txt

3. 运行应用

python app.py

使用 PowerShell 运行

有针对不同用途的 PowerShell 脚本：Install.ps1、Start-WebUI.ps1 和 Update.ps1。
它们使用 venv 执行上述相同操作，包括创建、激活 venv 和运行应用等。

如果您使用 Windows，请右键点击脚本，然后点击 使用 PowerShell 运行。

使用 Docker 运行

1. 克隆此仓库

git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git

2. 构建镜像

docker compose -f docker/docker-compose.yaml build

3. 运行容器

docker compose -f docker/docker-compose.yaml up

4. 在浏览器中连接到 http://localhost:7860/。

如果您不使用 Nvidia GPU，请更新 docker-compose.yaml 以匹配您的环境。

🌐 翻译

非常欢迎为 translation.yaml 提交语言翻译的 PR！

❤️ 致谢

1. LivePortrait 论文来自

@article{guo2024liveportrait,
  title   = {LivePortrait: Efficient Portrait Animation with Stitching and Retargeting Control},
  author  = {Guo, Jianzhu and Zhang, Dingyun and Liu, Xiaoqiang and Zhong, Zhizhou and Zhang, Yuan and Wan, Pengfei and Zhang, Di},
  journal = {arXiv preprint arXiv:2407.03168},
  year    = {2024}
}

2. 模型是由 kijai 转换的 safetensors 格式：https://github.com/kijai/ComfyUI-LivePortraitKJ
3. 使用 ultralytics 进行人脸检测。
4. 此 WebUI 源自 ComfyUI-AdvancedLivePortrait，AAA、EEE、眉毛、眨眼等各种面部表情由 PowerHouseMan 发现。
5. 使用 RealESRGAN 进行图像修复。

AdvancedLivePortrait-WebUI 快速上手指南

AdvancedLivePortrait-WebUI 是一个基于 Gradio 的 WebUI，专门用于编辑图像中人物的面部表情。它基于 LivePortrait 和 ComfyUI-AdvancedLivePortrait 开发。

环境准备

前置依赖

1. Python: 3.9 ≤ 版本 ≤ 3.12

   • 下载地址：https://www.python.org/downloads/release/python-3110/

2. CUDA（可选，仅 Nvidia GPU 用户需要）

   • 版本：12.4
   • 下载地址：https://developer.nvidia.com/cuda-12-4-0-download-archive?target_os=Windows

3. FFmpeg（可选，仅使用视频驱动时需要）

   • 下载地址：https://ffmpeg.org/download.html
   • 安装后需将 FFmpeg/bin 文件夹添加到系统 PATH 环境变量

安装步骤

方式一：本地运行

# 1. 克隆仓库
git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git

# 2. 进入目录
cd AdvancedLivePortrait-WebUI

# 3. 安装依赖
# 如不使用 Nvidia GPU，请使用 requirements-cpu.txt
pip install -r requirements.txt

# 4. 启动应用
python app.py

方式二：PowerShell 脚本（Windows）

项目提供了三个 PowerShell 脚本：

• Install.ps1 - 安装依赖
• Start-WebUI.ps1 - 启动 WebUI
• Update.ps1 - 更新项目

在 Windows 上右键点击脚本文件，选择 "使用 PowerShell 运行" 即可。

方式三：Docker 运行

# 1. 克隆仓库
git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git

# 2. 构建镜像
docker compose -f docker/docker-compose.yaml build

# 3. 启动容器
docker compose -f docker/docker-compose.yaml up

启动成功后，在浏览器访问 http://localhost:7860/ 即可使用。

注意：非 Nvidia GPU 用户需修改 docker-compose.yaml 配置。

基本使用

1. 启动应用后，在浏览器打开 WebUI 界面
2. 上传一张包含人脸的图片
3. 通过界面上的滑块或选项调整面部表情（如 AAA、EEE、眉毛、眨眼等）
4. 点击生成按钮获取处理后的图像

在线体验

• Google Colab: https://colab.research.google.com/github/jhj0517/AdvancedLivePortrait-WebUI/blob/master/notebooks/advanced_live_portrait_webui.ipynb
• Hugging Face Spaces: https://huggingface.co/spaces/jhj0517/AdvancedLivePortrait-WebUI