GeneFace++在CentOS如何启动

GeneFace++ 是一个基于 PyTorch 的语音驱动人脸视频生成（talking face）项目，官方主要面向 Ubuntu + Conda 环境。在 CentOS 上启动思路基本一致，只是系统依赖和驱动略有差异。下面给你一份可落地的 CentOS 启动流程。

一、环境准备（CentOS 7/8 均可）

1. 系统依赖

sudo yum install -y \
epel-release \
git \
ffmpeg \
libglvnd-glx \
mesa-libGL \
xz \
bzip2 \
gcc gcc-c++

⚠️ CentOS 7 默认 ffmpeg 可能没有，建议：

• 用 rpmfusion 或
• 直接下载静态 ffmpeg

2. 安装 Miniconda

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

二、克隆 GeneFace++ 并创建环境

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

创建环境（官方推荐）：

conda env create -f environment.yml
conda activate geneface++

如果 environment.yml 失败（CentOS 常见），可手动：

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

三、下载模型权重

bash scripts/download_pretrained.sh

或手动下载到：

checkpoints/

四、准备输入

# 音频
examples/audio/example.wav
# 参考视频（可选）
examples/ref_video/example.mp4

五、启动推理（核心）

1. 使用官方 Demo

python inference.py \
--a examples/audio/example.wav \
--v examples/ref_video/example.mp4 \
--o results/result.mp4

2. 使用 Web Demo（Gradio）

python app.py

访问：

http://<服务器IP>:7860

如果是远程 CentOS 服务器：

ssh -L 7860:localhost:7860 user@server_ip

六、CentOS 常见问题

❌ 1. GLIBC 版本过低

现象：

version 'GLIBC_2.29' not found

✅ 解决：

• CentOS 7 → 升级到 CentOS 8 / Rocky / Alma
• 或用 Docker

❌ 2. CUDA 不可用

nvidia-smi

若无输出 → 先装：

• NVIDIA 驱动
• CUDA 11.8

✅ 推荐：Docker 方式（最稳）

docker run --gpus all -it \
-v $PWD:/workspace \
pytorch/pytorch:1.13.1-cuda11.7-cudnn8-devel

七、最小成功验证

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

输出 True 即成功。

如果你愿意，可以告诉我：

• CentOS 版本（7 / 8 / Stream）
• 是否有 GPU
• 想用 命令行 / Web / API

我可以直接给你一套精确命令。