Win平台装GeneFace++教程

下面给你一份在 Windows 平台安装并运行 GeneFace++（GeneFace Plus Plus）的实用教程。GeneFace++ 官方主要面向 Linux，但 Windows 是可以跑的，只是步骤略多，建议严格按流程来。

一、环境准备

1. 系统要求

• Windows 10 / 11（64 位）
• NVIDIA 显卡（推荐 8G 以上显存）
• 已安装 NVIDIA 驱动

2. 安装基础软件

1. Git

• https://git-scm.com/

1. Anaconda / Miniconda

• https://www.anaconda.com/

1. CUDA & cuDNN

• 推荐 CUDA 11.8
• cuDNN 对应版本

二、克隆 GeneFace++ 项目

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

三、创建 Conda 环境

conda create -n geneface python=3.9
conda activate geneface

四、安装 PyTorch（Windows + CUDA 11.8）

pip install torch==2.0.1+cu118 torchvision==0.15.2+cu118 --index-url https://download.pytorch.org/whl/cu118

五、安装项目依赖

pip install -r requirements.txt

⚠️ 常见问题：

• 若 face-alignment 安装失败，可先：

pip install face-alignment

• 若 pyrender 报错（Windows 不支持 OpenGL），可跳过，不影响核心推理

六、安装额外 Windows 依赖

pip install pywin32
pip install soundfile
pip install librosa

七、下载预训练模型

官方模型（示例）：

mkdir -p data/checkpoints

从 README 提供的链接下载：

• genefacepp.pth
• 对应 meta.yaml

放到：

data/checkpoints/

八、准备输入数据

1. 音频

• 格式：.wav
• 采样率：16000 Hz

2. 参考视频 / 图像

• 用于驱动面部
• 建议 5–10 秒清晰正脸视频

九、运行推理（Windows 示例）

python inference.py \
--audio data/audio/example.wav \
--pose data/video/ref.mp4 \
--model_path data/checkpoints/genefacepp.pth \
--save_path output/result.mp4

十、常见问题（Windows 特有问题）

❌ 报错：GL 相关

✅ 解决：

• 不用 pyrender
• 设置环境变量：

set PYOPENGL_PLATFORM=osmesa

❌ 显存不足

✅ 解决：

• 降低分辨率
• 使用 --low_res

❌ ffmpeg 找不到

✅ 安装：

conda install ffmpeg

十一、推荐运行方式（稳定）

✅ WSL2（推荐）

• Windows 子系统跑 Linux
• 兼容性最好

十二、总结流程

Windows
├─ Anaconda
├─ CUDA 11.8
├─ GeneFace++
├─ PyTorch cu118
├─ 模型 + 音频
└─ inference.py

如果你愿意，我可以：

• ✅ 给你 一键安装脚本
• ✅ 教你 WSL2 安装方式
• ✅ 帮你 处理具体报错信息

直接把报错贴出来就行。