菜单

安装指南

相关源文件

本指南介绍了 Deep-Live-Cam 的安装过程,这是一款实时换脸和视频深度伪造应用程序。本文档解释了预编译和手动安装选项,以及如何设置 GPU 加速以获得最佳性能。

有关安装前的系统要求,请参阅 系统要求。有关安装后的使用说明,请参阅 用户指南

安装选项概述

Deep-Live-Cam 提供两种主要的安装方法:面向非技术用户的预编译包,以及面向更高级用户的从源代码手动安装。

来源: README.md33-39 README.md99-176

预编译安装 (Windows)

预编译版本适用于拥有 NVIDIA 或 AMD GPU 的 Windows 用户。这是最简单的安装方法,推荐给大多数希望快速上手使用的用户。

步数

  1. 访问 Deep-Live-Cam 官方网站: https://deeplivecam.net/index.php/quickstart
  2. 下载预编译包
  3. 将下载的文件解压到您选择的位置
  4. 运行可执行文件以启动应用程序

预编译安装会自动处理所有依赖项、模型下载和 GPU 配置,这对于非技术用户来说是理想的选择。

来源: README.md33-39

手动安装

手动安装提供更多控制权,并且对于没有预编译包的平台(Linux、macOS)或希望修改源代码的用户是必需的。

先决条件

在手动安装 Deep-Live-Cam 之前,请确保您已安装以下软件

必备组件版本备注
Python3.10 (推荐)其他版本可能导致兼容性问题
pip最新版Python 包管理器
git最新版用于克隆仓库
ffmpeg最新版视频处理所需
Visual Studio 2022 Runtimes最新版仅限 Windows

来源: README.md110-116

来源: models/instructions.txt1-4 README.md126-131

安装步骤

  1. 克隆仓库

  2. 下载模型文件

    下载以下 AI 模型文件,并将它们放在 models 文件夹中

    • GFPGANv1.4.pth - 用于人脸增强
    • inswapper_128_fp16.onnx - 用于人脸交换

    这些文件可以从以下地方下载

    https://hugging-face.cn/hacksider/deep-live-cam/resolve/main/GFPGANv1.4.pth
    https://hugging-face.cn/hacksider/deep-live-cam/resolve/main/inswapper_128_fp16.onnx
    
  3. 安装 Python 依赖项

    强烈建议使用虚拟环境,以避免与其他 Python 包发生冲突。

    适用于Windows

    适用于 macOS/Linux

    适用于 Apple Silicon (M1/M2/M3)

  4. 基本操作测试

    使用 CPU 处理运行(速度较慢,但适用于所有系统)

    注意:首次运行时可能会下载额外的模型文件(约 300MB)。

来源: README.md118-176 requirements.txt1-22

GPU加速设置

Deep-Live-Cam 支持多种硬件加速方法,以显著提高性能。请根据您的硬件选择合适的方法。

来源: README.md178-274 requirements.txt16-18

NVIDIA GPUs (CUDA)

  1. 安装 CUDA Toolkit 11.8.0

  2. 安装 CUDA 专用的 onnxruntime 包

  3. 使用 CUDA 加速运行

    或者,使用包含的批处理文件: run-cuda.bat

AMD/Intel GPUs (DirectML)

  1. 安装 DirectML 专用的 onnxruntime 包

  2. 使用 DirectML 加速运行

    或者,使用包含的批处理文件: run-directml.bat

Apple Silicon (M1/M2/M3)

  1. 请确保您使用的是 Python 3.10(Apple Silicon 支持特别需要)

  2. 安装 CoreML 专用的 onnxruntime 包

  3. 使用 CoreML 加速运行

    macOS 重要提示

    • 您必须使用 Python 3.10,而不是更新的版本
    • 如果您安装了多个 Python 版本,请始终使用 python3.10 命令运行
    • 如果您遇到关于缺少 _tkinter 的错误,请重新安装 tkinter: brew reinstall python-tk@3.10

Intel CPUs (OpenVINO)

  1. 安装 OpenVINO 专用的 onnxruntime 包

  2. 使用 OpenVINO 加速运行

来源: README.md178-274 README.md214-229

安装验证

为验证您的安装是否正常工作

  1. 运行应用程序

  2. 应用程序应启动并显示主界面

  3. 首次运行将按需下载其他模型

  4. 帧处理器应成功加载,如下面的 modules/processors/frame/core.py33-41所示。

  5. 尝试加载源图像以确认人脸检测是否正常工作

常见问题排查

虚拟环境问题

如果您需要重新安装虚拟环境

缺少模型

如果您遇到关于缺少模型的错误

  1. 请确保您已将所需的模型文件下载到 models 文件夹

    • GFPGANv1.4.pth
    • inswapper_128_fp16.onnx
  2. 检查 models 文件夹是否位于正确的位置(在 Deep-Live-Cam 的主目录中)

macOS 特定问题

  • 如果您使用 Apple Silicon (M1/M2/M3),请确保您使用的是 Python 3.10
  • 如果您遇到关于缺少 tkinter 的错误
  • 如果与其他 Python 版本发生冲突

GPU 加速问题

  • 如果应用程序尽管进行了 GPU 配置但运行缓慢,请检查您是否使用了正确的执行提供程序
  • 确保您为 GPU 安装了正确的驱动程序
  • 验证是否已为您的硬件安装了相应的 onnxruntime 包

来源: README.md162-175 README.md214-229

有关安装 Deep-Live-Cam 后的使用方法的更多信息,请参阅 用户指南用户界面 文档部分。