Windows安装GeneFace++有何步骤

在 Windows 上安装 GeneFace++（一个基于深度学习的语音驱动人脸动画生成项目）相对 Linux 来说会麻烦一些，因为它官方主要面向 Linux，且依赖较多（PyTorch、CUDA、音频处理、3D 相关库等）。下面给你一份相对完整、可落地的 Windows 安装步骤。

一、环境准备

1. 系统要求

• Windows 10 / 11（64 位）
• NVIDIA 显卡（推荐 RTX 系列）
• 已安装 NVIDIA 驱动

2. 安装 CUDA 和 cuDNN

GeneFace++ 通常依赖 CUDA 11.x

1. 安装 CUDA 11.7 或 11.8

• https://developer.nvidia.com/cuda-toolkit-archive

1. 安装对应 cuDNN

• https://developer.nvidia.com/cudnn

1. 配置环境变量（一般安装器会自动加）

验证：

nvcc -V

二、安装 Python 环境

方式一（推荐）：使用 Miniconda

1. 安装 Miniconda（Windows 版）
2. 创建环境：

conda create -n geneface python=3.8
conda activate geneface

三、安装 PyTorch（GPU 版）

根据你 CUDA 版本选择命令，例如 CUDA 11.8：

pip install torch==1.13.1+cu117 torchvision==0.14.1+cu117 --extra-index-url https://download.pytorch.org/whl/cu117

⚠️ GeneFace++ 对 PyTorch 版本较敏感，推荐 1.13.x

四、克隆 GeneFace++ 代码

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

五、安装依赖

1. 基础依赖

pip install -r requirements.txt

2. Windows 特别注意事项

（1）pywin32

pip install pywin32

（2）scikit-image / numpy 版本

若报错：

pip install "numpy<1.24" scikit-image==0.19.3

（3）face-alignment / dlib

Windows 下 dlib 易失败，建议：

conda install -c conda-forge dlib
pip install face-alignment

六、安装音频 / 视频相关库

pip install librosa soundfile moviepy

如 moviepy 报错：

pip install imageio imageio-ffmpeg

七、下载预训练模型

GeneFace++ 需要：

• audio2motion 模型
• motion2video 模型

参考官方 README：

bash scripts/download_pretrained.sh

Windows 无 bash，可手动下载并放到：

checkpoints/

八、运行测试

1. 音频驱动面部运动

python inference.py --pgvs_mode fast --a2m_model_path checkpoints/audio2motion --m2v_model_path checkpoints/motion2video --inp audio/test.wav --out output.mp4

2. 常见问题

• CUDA out of memory → 减小 batch / 分辨率
• dlib 找不到 → 重装 dlib
• ffmpeg 缺失 → 安装 ffmpeg 并加入 PATH

九、推荐方案（更省事）

如果你在 Windows 上遇到太多坑，强烈建议：

• 使用 WSL2 + Ubuntu
• 或 Docker（Linux 容器）

这是 GeneFace++ 最稳定的运行方式。

如果你愿意，我可以：

• 给你一份 Windows 专属 requirements 清单
• 或一步步陪你 从零配置到成功推理
• 或帮你判断 你的显卡是否适合跑 GeneFace++

你现在是准备训练还是只推理？