Windows装GeneFace++需要哪些库

在 Windows 上安装和运行 GeneFace++（基于音频驱动面部动画的开源项目），通常需要以下依赖库和环境。GeneFace++ 官方主要支持 Linux，但在 Windows 上也可以跑，只是需要自己配置好环境。

一、基础环境

1. Python 环境

• Python 3.8 / 3.9（推荐）
• 建议使用 conda 或 venv 隔离环境

conda create -n geneface python=3.9
conda activate geneface

二、核心深度学习库

2. PyTorch（Windows 版）

根据是否有 GPU 选择：
CPU 版：

pip install torch torchvision torchaudio

GPU 版（CUDA 11.8 示例）：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

⚠️ GeneFace++ 强烈建议使用 NVIDIA GPU + CUDA

三、GeneFace++ 官方依赖库

pip install -r requirements.txt

常见库包括（重点）：

3. 视觉 / 图形

• opencv-python
• imageio
• imageio-ffmpeg
• scikit-image
• pyrender（Windows 需额外配置）
• trimesh

4. 音频处理

• librosa
• soundfile
• numpy
• scipy

5. 训练 / 推理

• tensorboard
• tqdm
• yaml
• matplotlib

四、Windows 特有依赖（容易踩坑）

6. 编译工具

• Visual Studio Build Tools（C++）
• 安装时勾选：

✅ “使用 C++ 的桌面开发”

7. pyrender / OpenGL（重要）

Windows 下 pyrender 常报错：

No module named 'pyopengl'

解决：

pip install pyopengl pyopengl-accelerate

如使用 WSL 或远程桌面，可能无法渲染，需要：

• 使用 egl 模式
• 或修改代码跳过可视化

五、可选但常用

• ffmpeg（系统级，必须加到 PATH）
• git
• CUDA + cuDNN（GPU 必需）

六、简要安装流程（Windows）

git clone https://github.com/yerfor/GeneFacePlusPlus.git
cd GeneFacePlusPlus
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

七、常见问题

❌ pyrender 无法显示
✅ 使用 headless 模式或改代码
❌ librosa 报错
✅ 升级 numba
❌ 推理慢

✅ 确认 CUDA 是否可用（torch.cuda.is_available()）

如果你愿意，我可以：

• ✅ 给你一份 Windows 专用 requirements.txt
• ✅ 手把手教你 Windows 跑推理 demo
• ✅ 对比 GeneFace / GeneFace++ / SadTalker

你打算 训练还是只推理？