Linux系统如何部署GeneFace Plus Plus

一、安装前准备

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

sudo yum install -y cmake git python3 python3-devel libpng-devel libjpeg-devel libtiff-devel
（注：若使用Python虚拟环境，需提前安装virtualenv或conda）。
二、获取源码
从GitHub克隆GeneFace++官方仓库（需替换为实际仓库地址，如yerfor/GeneFacePlusPlus或biocontainers/geneface）：
git clone https://github.com/your-repo/GeneFacePlusPlus.git
进入项目目录：cd GeneFacePlusPlus。
三、编译安装（源码方式）

1. 创建并进入编译目录：mkdir build && cd build。
2. 生成Makefile：cmake ..（若项目包含CMakeLists.txt文件）。
3. 编译源码：make（等待编译完成，耗时取决于系统性能）。
4. 安装到系统目录：sudo make install（需管理员权限）。

四、Python环境配置（可选，若项目含Python模块）

1. 创建虚拟环境（推荐隔离依赖）：

使用conda创建名为geneface的环境并激活：
conda create -n geneface python=3.9
conda activate geneface

1. 安装Python依赖：

• 安装ffmpeg（多媒体处理）：conda install conda-forge::ffmpeg。
• 安装PyTorch（深度学习框架）：

conda install pytorch==2.0.1 torchvision==0.15.2 torchaudio==2.0.2 pytorch-cuda=11.7 -c pytorch -c nvidia

• 安装PyTorch3D（3D数据处理）：

pip install "git+https://github.com/facebookresearch/pytorch3d.git@stable"

• 安装MMCV（多媒体计算工具包）：

pip install cython openmim==0.3.9
mim install mmcv==2.1

• 安装项目自身依赖：pip install -r requirements.txt。

五、配置环境变量（可选，若安装路径非标准）
若将GeneFace++安装到非系统标准路径（如/opt/geneface），需添加路径到环境变量：

1. 编辑~/.bashrc或~/.bash_profile文件：

echo 'export PATH=$PATH:/opt/geneface/bin' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/geneface/lib' >> ~/.bashrc
（注：路径需替换为实际安装路径）

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

六、测试安装

1. 源码方式：运行项目提供的测试脚本（如test_gene_face.py），检查是否有报错。
2. Python方式：执行示例脚本（如inference/genefacepp_infer.py），验证功能是否正常：

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_auddata/raw/val_wavs/MacronSpeech.wav --out_name may_demo.mp4
（注：示例命令需根据项目实际参数调整）。
七、常见问题解决

1. 权限问题：安装或编译时使用sudo获取管理员权限。
2. 依赖缺失：根据错误提示安装缺失的库（如libxxx-devel），或更换国内Yum镜像源（如清华大学镜像）加速下载。
3. 防火墙/SELinux：临时关闭防火墙（systemctl stop firewalld）或SELinux（setenforce 0），避免阻止安装进程。
4. 依赖冲突：更新pip（pip install --upgrade pip）和conda（conda update conda），或使用虚拟环境隔离依赖。