GeneFace++在Windows怎部署

AI技术
小华
2026-09-06

GeneFace++ 是一个基于深度学习的语音驱动虚拟人( talking face / 数字人)项目,官方主要面向 Linux(Ubuntu) 环境开发与测试,在 Windows 上部署有一定门槛,但并非不可能。下面给你一套相对可行、少踩坑的 Windows 部署思路

一、总体方案(推荐)

推荐方案:Windows + WSL2(Ubuntu)

最接近官方环境,兼容性最好,强烈推荐
备选:
  • 纯 Windows(Conda + CUDA)✅ 可行但问题多
  • Docker(Windows Docker Desktop)⚠️ 可行但不如 WSL2

二、推荐方案:WSL2 + Ubuntu(最稳)

1. 安装 WSL2

wsl --install

安装 Ubuntu 20.04 / 22.04

2. 安装 CUDA(WSL 专用)

  • 安装 NVIDIA 驱动(Windows 端)
  • WSL 内安装 CUDA Toolkit(不需要单独装驱动)

3. 克隆项目

git clone https://github.com/liangchen666/GeneFacePlusPlus.git
cd GeneFacePlusPlus

4. 创建 Conda 环境

conda create -n geneface python=3.9
conda activate geneface

5. 安装依赖

pip install -r requirements.txt

常见依赖:

  • torch
  • torchaudio
  • face-alignment
  • diffusers
  • transformers

⚠️ 注意:

  • 使用 CUDA 版本 torch
  • 建议手动安装对应版本,避免自动装 CPU 版

三、纯 Windows 部署(不推荐但可行)

1. 环境

  • Windows 10 / 11
  • Anaconda
  • NVIDIA 显卡 + CUDA 11.8

2. 步骤

conda create -n geneface python=3.9
conda activate geneface
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
pip install -r requirements.txt

3. 常见问题

问题解决
face-alignment 报错降低 dlib 版本
ffmpeg 找不到安装并加入 PATH
路径问题\ 改成 /
中文路径全部用英文路径

四、模型与数据准备

GeneFace++ 需要:

  • 音频特征模型
  • 人脸模型
  • 预训练权重

官方提供:

  • 示例模型
  • 训练脚本

⚠️ 模型文件较大,建议手动下载并放指定目录

五、运行 Demo

python inference.py \
--audio example.wav \
--model_path checkpoints/xxx

六、总结建议

最稳:WSL2 Ubuntu
⚠️ 能跑:纯 Windows
不建议:原生 CMD
如果你愿意,可以告诉我:

  • 是否有 NVIDIA 显卡
  • Windows 版本
  • 是否只想「推理」还是「训练」

我可以给你更精确的命令和版本搭配

亿速云提供售前/售后服务

售前业务咨询

售后技术保障

400-100-2938

7*24小时售后电话

官方微信小程序