如何在CentOS安装GeneFace++

以下是在 CentOS 上安装 GeneFace++ 的详细步骤。GeneFace++ 是一个基于深度学习的说话人生成项目，依赖较多，建议在 CentOS 7/8 且具备 NVIDIA GPU 的环境下安装。

一、系统与环境准备

1. 操作系统

• CentOS 7 或 CentOS 8（推荐 CentOS 7）
• 已安装 NVIDIA 显卡驱动

检查驱动：

nvidia-smi

二、安装基础依赖

1. 安装系统工具

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

三、安装 CUDA 与 cuDNN（GPU 必需）

1. 安装 CUDA（以 CUDA 11.7 为例）

wget https://developer.download.nvidia.com/compute/cuda/repos/rhel7/x86_64/cuda-repo-rhel7-11.7.0-1.x86_64.rpm
sudo rpm -i cuda-repo-rhel7-11.7.0-1.x86_64.rpm
sudo yum clean all
sudo yum install -y cuda

配置环境变量：

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

2. 安装 cuDNN

从 NVIDIA 官网下载对应 CUDA 版本的 cuDNN（需账号）：

tar -xzvf cudnn-11.7-linux-x64-v8.x.x.x.tgz
sudo cp cuda/include/cudnn*.h /usr/local/cuda/include/
sudo cp cuda/lib64/libcudnn* /usr/local/cuda/lib64/
sudo chmod a+r /usr/local/cuda/include/cudnn*.h
sudo chmod a+r /usr/local/cuda/lib64/libcudnn*

四、安装 Python 环境（推荐 Conda）

1. 安装 Miniconda

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

2. 创建 Python 虚拟环境

GeneFace++ 通常基于 Python 3.8/3.9

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

五、克隆 GeneFace++ 仓库

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

六、安装 Python 依赖

1. 安装 PyTorch（CUDA 11.7）

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

检查：

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

2. 安装项目依赖

pip install -r requirements.txt

如果缺少某些包（如 librosa, numpy, tqdm, opencv-python）：

pip install librosa numpy tqdm opencv-python

七、安装第三方工具（常见）

1. ffmpeg

sudo yum install -y ffmpeg

若无可用包，可从源码编译或使用 rpm：

wget https://download1.rpmfusion.org/free/el/updates/7/x86_64/f/ffmpeg-3.4.13-1.el7.x86_64.rpm
sudo rpm -ivh ffmpeg-*.rpm

八、下载模型权重

GeneFace++ 需要预训练模型（如音频编码器、3DMM、渲染模型等），参考官方 README 中的模型下载链接。
示例：

mkdir -p checkpoints
cd checkpoints
# 下载模型（示例，具体以官方为准）
wget <模型下载地址>

九、运行示例

python inference.py \
--audio_path test/audio.wav \
--model_path checkpoints/geneface++.pth

十、常见问题

1. GLIBC / GCC 版本过低

CentOS 7 默认 gcc 版本较低，可升级：

sudo yum install centos-release-scl
sudo yum install devtoolset-9
scl enable devtoolset-9 bash

2. pip 安装超时

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. CUDA 与 PyTorch 不匹配

确认版本对应：

十一、注意事项

✅ 建议在 GPU + Conda 环境下安装
✅ 不要混用系统 Python
✅ 严格按照官方 README 安装模型

✅ 音频、视频处理依赖 ffmpeg

如果你需要：

• 指定型号的 GPU 配置
• CentOS 8 / Rocky / AlmaLinux
• 仅 CPU 版本
• Docker 安装方式

可以告诉我，我可以给你定制安装方案。