CentOS中GeneFace++安装指南 - AI技术

CentOS系统安装GeneFace++指南

1. 安装前准备

系统更新：运行sudo yum update -y确保系统软件包为最新版本，避免兼容性问题。
创建Python环境：GeneFace++基于PyTorch开发，建议使用conda创建独立Python环境（如conda create -n geneface python=3.9），激活环境（conda activate geneface）以隔离依赖。

2. 安装系统依赖

GeneFace++需要C++编译工具、Python开发库及多媒体处理库，通过以下命令安装：

sudo yum groupinstall -y "Development Tools"  # 安装gcc、make等基础开发工具
sudo yum install -y cmake git wget          # 安装构建工具与版本控制工具
sudo yum install -y python3 python3-devel   # 安装Python3及头文件
sudo yum install -y libpng-devel libjpeg-devel libtiff-devel  # 多媒体文件处理依赖

若使用CUDA加速（推荐），需额外安装NVIDIA驱动、CUDA Toolkit及cuDNN（参考NVIDIA官方文档）。

3. 下载GeneFace++源代码

从GitHub克隆官方仓库（替换为实际地址，如yerfor/GeneFacePlusPlus）：

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

确保仓库地址正确，避免因地址错误导致后续步骤失败。

4. 编译与安装

创建构建目录：进入项目目录后，新建build目录用于编译（避免污染源码）：

mkdir build && cd build

配置编译选项：运行cmake ..生成Makefile，系统会自动检测依赖项。若依赖缺失，需根据提示安装对应库。
编译源码：使用make -j$(nproc)并行编译（nproc获取CPU核心数，加速编译），编译完成后执行sudo make install将程序安装至系统默认路径（如/usr/local/bin）。

5. 配置Python环境与依赖

安装Python依赖：进入项目根目录，通过pip安装Python依赖（requirements.txt包含PyTorch、Gradio等库）：

pip install -r requirements.txt

设置环境变量：将项目根目录添加至PYTHONPATH，确保Python能找到GeneFace++模块：

export PYTHONPATH=$(pwd):$PYTHONPATH

若需永久生效，可将上述命令添加至~/.bashrc或~/.bash_profile，运行source ~/.bashrc使更改生效。

6. 下载预处理数据与模型权重

GeneFace++需预训练模型及3DMM文件才能运行，需手动下载并放置至指定目录：

3DMM文件：下载BFM模型文件至./deep_3drecon/BFM目录（可从GitHub仓库的data分支获取）。
数据集：下载预处理数据集（如May数据集），解压后放至./data/binary/videos/May目录。
预训练模型：获取audio2motion_vae（音频转动作）、motion2video_nerf（动作转视频）等模型权重，放置至对应checkpoints目录（如./checkpoints/audio2motion_vae、./checkpoints/motion2video_nerf/may_head）。

7. 运行测试示例

执行示例脚本生成视频，验证安装是否成功：

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

替换--drv_aud参数为实际音频文件路径（如./data/raw/val_wavs/MacronSpeech.wav）。
运行成功后，demo_output.mp4将保存在当前目录，可通过播放器查看生成的视频。

8. 可选：配置为系统服务（后台运行）

若需让GeneFace++后台持续运行，可创建systemd服务：

新建服务文件：sudo nano /etc/systemd/system/geneface.service，添加以下内容（替换路径为用户实际路径）：

[Unit]
Description=GeneFace++ Service
After=network.target
[Service]
ExecStart=/path/to/GeneFacePlusPlus/build/bin/geneface++
Restart=always
User=your_username
Group=your_groupname
[Install]
WantedBy=multi-user.target

启动并启用服务：

sudo systemctl daemon-reload
sudo systemctl start geneface
sudo systemctl enable geneface

查看日志：sudo journalctl -u geneface -f（实时跟踪运行状态）。

常见问题解决

权限问题：若编译或安装时报权限错误，可在命令前添加sudo（如sudo make install）。
依赖冲突：若pip install时报依赖冲突，可升级pip（pip install --upgrade pip）后重新安装。
路径错误：若运行脚本时报“command not found”，需检查PATH环境变量是否包含GeneFace++的安装路径（如/usr/local/bin）。