CentOS如何完美安装GeneFace Plus Plus

一、安装前准备

1. 系统更新：运行sudo yum update -y确保系统软件包为最新版本，避免兼容性问题。
2. 依赖项安装：安装编译工具、Python环境及多媒体处理库，命令如下：

sudo yum install -y cmake git python3 python3-devel libpng-devel libjpeg-devel libtiff-devel。

1. GPU驱动检查（可选但推荐）：若需加速模型推理，确保已安装NVIDIA GPU驱动及对应CUDA版本（需与GeneFace++要求的版本匹配，如CUDA 11.7+）。

二、获取GeneFace++源码

1. 克隆仓库：从官方或可信来源克隆GeneFace++代码（以yerfor/GeneFacePlusPlus为例），替换为实际仓库地址：

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

1. 进入项目目录：cd GeneFacePlusPlus。

三、创建并配置Python虚拟环境

1. 创建虚拟环境：使用conda或venv隔离Python环境（避免依赖冲突），例如：

conda create -n geneface python=3.9（conda）或python3 -m venv geneface（venv）。

1. 激活虚拟环境：

• conda：conda activate geneface
• venv：source geneface/bin/activate。

四、安装Python依赖

1. 安装requirements.txt中的依赖：在项目根目录下运行：

pip install -r requirements.txt（确保pip为最新版本，可通过pip install --upgrade pip升级）。
五、编译安装C++组件（若有）

1. 创建build目录：mkdir build && cd build。
2. 生成Makefile：cmake ..（若需自定义编译选项，可在此步骤添加参数，如-DCMAKE_INSTALL_PREFIX=/usr/local/geneface）。
3. 编译并安装：make（编译源码），sudo make install（安装至系统目录）。

六、配置环境变量（可选但推荐）

1. 添加路径到环境变量：若安装路径非标准（如/usr/local/geneface），需将以下内容添加到~/.bashrc或~/.bash_profile：

export PATH=$PATH:/path/to/GeneFacePlusPlus/bin（可执行文件路径）
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/GeneFacePlusPlus/lib（库文件路径）。

1. 使配置生效：source ~/.bashrc或source ~/.bash_profile。

七、下载预处理数据与模型权重

1. 下载3DMM文件：将3DMM模型文件（如BFM）放置到./deep_3drecon/BFM目录。
2. 获取预处理数据集：下载示例数据集（如May数据集），解压后放入./data/binary/videos/May。
3. 下载预训练模型：获取audio2motion_vae、motion2video_nerf等预训练模型，放置到对应checkpoints目录（如./checkpoints/audio2motion_vae、./checkpoints/motion2video_nerf/may_head）。

八、测试安装

1. 设置Python路径：export PYTHONPATH=$(pwd):$PYTHONPATH（将项目根目录加入Python搜索路径）。
2. 运行示例脚本：执行推理脚本（替换音频文件路径为实际路径，如/home/user/audio/example.wav）：

`python inference/genefacepp_infer.py \
--a2m_ckpt=checkpoints/audio2motion_vae \
--head_ckpt=checkpoints/motion2video_nerf/may_head \
--torso_ckpt=checkpoints/motion2video_nerf/may_torso \
--drv_aud=data/raw/val_wavs/example.wav \
--out_name=demo_output.mp4`。

1. 验证结果：若脚本成功运行并生成demo_output.mp4，则说明安装完成。

注意事项

• 版本兼容性：确保CentOS版本（如CentOS 7/8）与GeneFace++要求的Linux内核版本匹配。
• 防火墙配置：若安装过程中需要下载外部资源，临时关闭防火墙或开放对应端口：sudo systemctl stop firewalld（测试后记得开启：sudo systemctl start firewalld）。
• SELinux配置：若遇到权限问题，可临时设置为宽松模式：sudo setenforce 0（测试后恢复：sudo setenforce 1）。
• 官方文档优先：若安装过程中遇到问题，优先参考GeneFace++项目的README.md或GitHub Issues页面，获取最新解决方案。