如何CentOS安装GeneFace++

下面给你一份在 CentOS 上安装 GeneFace++ 的完整实战指南，尽量覆盖“系统准备 → 环境 → 模型 → 常见坑”。GeneFace++ 本身主要依赖 Python + PyTorch + CUDA，CentOS 7/8 都可以，但建议 CentOS 7 + 手动安装新 GCC。

一、系统与硬件要求

✅ 推荐配置

OS：CentOS 7（8 也可，但部分库更麻烦）
GPU：NVIDIA（≥ 4GB 显存，建议 8GB+）
CUDA：11.7 / 11.8（GeneFace++ 常用组合）
Python：3.8 或 3.9

二、系统基础环境准备

1️⃣ 更新系统

sudo yum update -y

2️⃣ 安装基础工具

sudo yum install -y \
git wget curl unzip \
epel-release \
gcc gcc-c++ make

三、升级 GCC（非常重要）

CentOS 7 默认 GCC 是 4.8，GeneFace++ 编译会失败。

安装 devtoolset-11

sudo yum install -y centos-release-scl
sudo yum install -y devtoolset-11

启用：

scl enable devtoolset-11 bash

✅ 建议加入 .bashrc：

echo "source /opt/rh/devtoolset-11/enable" >> ~/.bashrc

验证：

gcc --version

四、安装 NVIDIA 驱动 + CUDA

1️⃣ 安装 NVIDIA 驱动

lspci | grep -i nvidia

推荐方式（自动）：

sudo yum install -y nvidia-driver nvidia-settings

重启后验证：

nvidia-smi

2️⃣ 安装 CUDA 11.7

wget https://developer.download.nvidia.com/compute/cuda/11.7.1/local_installers/cuda_11.7.1_515.65.01_linux.run
sudo sh cuda_11.7.1_linux.run

添加环境变量：

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

五、安装 Conda（强烈推荐）

安装 Miniconda

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

初始化：

conda init bash

六、创建 GeneFace++ 虚拟环境

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

七、安装 PyTorch（CUDA 版本）

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

验证：

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

✅ 应为 `True`

八、下载 GeneFace++ 项目

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

九、安装 Python 依赖

pip install -r requirements.txt

⚠️ 常见失败点：

opencv-python-headless
face-alignment
librosa

若 opencv 失败：

pip install opencv-python-headless

若 face-alignment 失败：

pip install face-alignment --no-deps

十、下载模型权重（关键）

GeneFace++ 需要以下模型：

1️⃣ 下载官方模型

bash scripts/download_models.sh

如果脚本失败，可手动下载：

HuggingFace / GeneFace++

目录结构建议：

GeneFacePlusPlus/
├── checkpoints/
│   ├── audio2motion/
│   ├── motion2video/
│   └── ...

十一、准备数据（示例）

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

十二、CentOS 常见错误 & 解决方案

❌ GLIBC / GCC 版本过低

✅ 使用 `devtoolset-11`

❌ libtorch_cuda not found

✅ CUDA 与 PyTorch 不匹配

✅ 确认 `torch.version.cuda`

❌ OpenCV 无法加载 so

sudo yum install -y mesa-libGL

❌ 显存不足

降低 batch_size
使用 FP16
使用小分辨率

十三、验证是否安装成功

python -c "
import torch
print('CUDA:', torch.cuda.is_available())
print('GPU:', torch.cuda.get_device_name(0))
"

十四、总结安装顺序（速查）

CentOS
↓
GCC 升级
↓
NVIDIA 驱动 + CUDA
↓
Conda
↓
Python 3.8
↓
PyTorch CUDA
↓
GeneFace++ 代码
↓
模型权重
↓
推理 / 训练

如果你愿意，我可以：
✅ 给你 “一步步复制粘贴版”脚本
✅ 解决 你现在具体报的错（贴日志）
✅ 教你 只用 CPU 跑 GeneFace++（不推荐但可行）
✅ 帮你 在服务器上做推理自动化
直接告诉我你现在的 CentOS 版本 + GPU 型号 + 报错信息 即可。