CentOS安装GeneFace Plus Plus技巧

CentOS安装GeneFace++技巧与步骤

一、安装前准备

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

sudo yum install -y cmake git python3 python3-devel libpng-devel libjpeg-devel libtiff-devel
（注：若使用CUDA加速，需额外安装对应版本的CUDA Toolkit及cuDNN，建议参考NVIDIA官方文档）。

1. 仓库地址确认：从GeneFace++官方GitHub（如https://github.com/yerfor/GeneFacePlusPlus）获取最新仓库地址，替换安装步骤中的URL。

二、源码编译安装

1. 克隆仓库：使用git clone命令下载源码，例如：

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

1. 创建构建目录：进入项目根目录，新建build目录并进入，用于隔离编译过程：

mkdir build && cd build。

1. 配置编译选项：运行cmake ..生成Makefile，可根据需求添加编译选项（如指定安装路径-DCMAKE_INSTALL_PREFIX=/usr/local/geneface）。
2. 编译与安装：执行make -j$(nproc)（使用所有CPU核心加速编译），完成后用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  # 添加库文件路径

运行source ~/.bashrc使配置生效。

四、Python环境配置（针对Python模块）

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

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

1. 激活环境：运行conda activate geneface（或source geneface/bin/activate）进入虚拟环境。
2. 安装Python依赖：在项目根目录下执行pip install -r requirements.txt，安装PyTorch、Gradio等Python依赖。

五、测试与验证

1. 运行测试脚本：进入inference目录，执行示例脚本（需替换音频文件路径）：

export PYTHONPATH=$(pwd):$PYTHONPATH  # 添加项目路径到Python搜索路径
python 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

若生成demo_output.mp4且视频播放正常，则安装成功。

六、常见问题解决技巧

1. 依赖缺失：若编译时报错缺少库（如libpng），用sudo yum install -y libpng-devel安装对应开发包。
2. Python环境冲突：若安装Python依赖时报错，检查虚拟环境是否激活，或用pip install --upgrade pip升级pip工具。
3. 权限问题：若安装或运行时报错权限不足，使用sudo提升权限（仅对系统目录操作需要）。
4. 防火墙/SELinux：若需访问网络资源（如下载模型），临时关闭防火墙（sudo systemctl stop firewalld）或配置SELinux为宽松模式（setenforce 0）。