CentOS上GeneFace++安装教程 - AI技术

CentOS上安装GeneFace++教程

1. 准备工作

确保CentOS系统已更新至最新版本，避免因系统包版本过低导致依赖冲突：

sudo yum update -y

建议使用conda或venv创建独立的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（安装CMake构建工具及Git版本控制工具）
sudo yum install -y python3 python3-devel libpng-devel libjpeg-devel libtiff-devel（安装Python 3开发库及常用图像格式支持库）

3. 下载GeneFace++源代码

从GeneFace++官方GitHub仓库克隆源代码（请替换为实际仓库地址，如https://github.com/yerfor/GeneFacePlusPlus.git）：
git clone https://github.com/your-repo/GeneFacePlusPlus.git
cd GeneFacePlusPlus（进入项目目录）

4. 编译与安装

创建构建目录并进入（CMake推荐的分步编译方式）：

mkdir build && cd build

生成Makefile（根据项目配置自动适配系统环境）：

cmake ..

编译源代码（-j$(nproc)使用所有CPU核心加速编译，缩短等待时间）：

make -j$(nproc)

安装编译后的文件到系统目录（需管理员权限）：

sudo make install

5. 配置环境变量（可选但推荐）

若安装路径不在系统默认路径（如/usr/local/bin）中，需手动添加环境变量，方便全局调用：

编辑用户级配置文件（如~/.bashrc或~/.bash_profile）：

nano ~/.bashrc

在文件末尾添加以下内容（替换/path/to/GeneFacePlusPlus为实际安装路径）：

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

使配置生效：

source ~/.bashrc

6. 测试安装

运行GeneFace++帮助命令，验证是否安装成功：

geneface++ --help
若显示帮助信息（如支持的命令、参数说明），则说明安装完成。

（可选）运行项目提供的测试脚本（如推理脚本），进一步验证功能：

参考项目文档中的示例命令（需替换音频文件路径为实际路径）：
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

7. 配置为系统服务（可选）

若需要让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_user
Group=your_group
[Install]
WantedBy=multi-user.target

启动并启用服务：

sudo systemctl daemon-reload（重新加载systemd配置）
sudo systemctl start geneface++（启动服务）
sudo systemctl enable geneface++（设置开机自启）

查看服务日志（实时跟踪运行状态）：

sudo journalctl -u geneface++ -f

注意事项

版本兼容性：确保GeneFace++版本与CentOS系统版本（如CentOS 7/8）、Python版本（如3.9+）匹配，避免因版本不兼容导致安装失败。
依赖问题：若编译或运行时提示缺少依赖，可根据错误信息安装对应库（如yum install -y 缺失的库名）。
官方文档：以上步骤为通用指南，具体操作请以GeneFace++官方文档或GitHub仓库的README文件为准（可能包含项目特定的配置要求）。