怎样在CentOS部署GeneFace Plus Plus

在 CentOS 上部署 GeneFace++（GeneFace Plus Plus） 属于比较偏“科研+工程”的操作，官方主要面向 Ubuntu + CUDA 环境。下面我按可落地步骤给你一个CentOS 适配版部署指南，并标注常见坑点。

一、GeneFace++ 简介（先确认你要部署的版本）

GeneFace++ 是基于 NeRF + 音频驱动 的说话人头部生成项目，核心依赖：

• Python 3.8+
• PyTorch（CUDA）
• CUDA / cuDNN
• NeRF 相关库（如 tinycudann）
• ffmpeg
• 音频处理库（librosa、soundfile 等）

官方仓库（以主流为准）：

https://github.com/yerfor/GeneFacePlusPlus

二、CentOS 环境准备（非常关键）

1️⃣ 系统版本建议

✅ 推荐：

• CentOS 7（glibc ≥ 2.17）
• CentOS 8 / Rocky / Alma（更友好）

❌ 不推荐：

• CentOS 6（glibc 太旧）

查看系统：

cat /etc/centos-release

2️⃣ 更新系统 & 基础工具

sudo yum update -y
sudo yum groupinstall -y "Development Tools"
sudo yum install -y \
wget curl git unzip \
epel-release

三、安装 GPU 驱动 & CUDA（重点）

1️⃣ 查看显卡

lspci | grep -i nvidia

2️⃣ 安装 NVIDIA 驱动（示例）

sudo yum install -y kmod-nvidia

或手动安装（推荐）：

https://www.nvidia.com/Download/index.aspx

验证：

nvidia-smi

3️⃣ 安装 CUDA（推荐 11.7 / 11.8）

sudo yum install -y cuda-11-8

或 runfile 安装。
配置环境变量：

echo 'export PATH=/usr/local/cuda-11.8/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/cuda-11.8/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

四、安装 Python（强烈建议 Conda）

1️⃣ 安装 Miniconda

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh

2️⃣ 创建 Python 环境

conda create -n geneface python=3.9 -y
conda activate geneface

✅ 推荐 Python 3.9（兼容性最好）

五、克隆 GeneFace++ 仓库

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

六、安装 PyTorch（CUDA 版本）

⚠️ 一定要和 CUDA 对应

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

验证：

python -c "import torch; print(torch.cuda.is_available())"

七、安装核心依赖（重点）

1️⃣ 安装 tinycudann（最容易失败）

pip install git+https://github.com/NVlabs/tiny-cuda-nn.git

❗ 常见错误 & 解决：

• gcc 版本太低 → 升级 gcc

sudo yum install -y devtoolset-11
scl enable devtoolset-11 bash

• CUDA 不匹配 → 一定要一致

2️⃣ 安装项目依赖

pip install -r requirements.txt

⚠️ 如果某些包失败：

• 先跳过
• 手动逐个安装

八、安装 ffmpeg（音频必须）

sudo yum install -y ffmpeg

或静态编译版（推荐）：

wget https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz

九、下载模型权重（必须）

GeneFace++ 需要：

• 3DMM 模型
• NeRF 模型
• 音频编码器

按官方 README 下载并放到：

checkpoints/

十、运行 Demo（验证部署）

python inference.py \
--audio_path examples/audio.wav \
--out_path output.mp4

✅ 成功说明部署完成

十一、CentOS 常见坑总结（非常重要）

十二、我可以继续帮你做什么？

你可以继续问我：
✅ CentOS 7 / 8 具体报错日志分析
✅ GeneFace++ 推理速度优化
✅ 改成 CPU 推理（不推荐）
✅ Docker 化部署方案
✅ 和 Wav2Lip / SadTalker 对比部署
只要把 系统版本 + GPU + 报错信息 发我，我可以直接帮你定位 ✅