CentOS下GeneFace++安装方法

AI技术
小华
2025-09-28

CentOS下GeneFace++安装步骤(基于开源项目适配)

1. 准备工作

  • 系统更新:确保系统软件包为最新版本,避免兼容性问题。
sudo yum update -y
  • 安装开发工具链:GeneFace++(尤其是基于PyTorch的版本)需要编译工具和基础开发库。
sudo yum groupinstall -y "Development Tools"  # 安装gcc、make等基础工具
sudo yum install -y cmake git wget          # 安装cmake(构建工具)、git(代码托管库)

2. 克隆GeneFace++源代码

从官方或可信GitHub仓库克隆项目(需替换为实际仓库地址,如yerfor/GeneFacePlusPlus):

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

3. 创建并激活Python虚拟环境

GeneFace++依赖Python 3.9+及多个第三方库,建议使用虚拟环境隔离依赖:

# 使用conda创建环境(推荐,需提前安装conda)
conda create -n geneface python=3.9
conda activate geneface
# 或使用venv(Python内置工具)
python3 -m venv geneface
source geneface/bin/activate

4. 安装Python依赖

项目根目录下的requirements.txt文件列出了所有Python依赖,使用pip安装:

pip install -r requirements.txt

注意:若requirements.txt未包含CUDA相关依赖(如torch的CUDA版本),需手动安装匹配的PyTorch版本(参考PyTorch官网),例如:

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118  # CUDA 11.8版本

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

GeneFace++需要3DMM模型、预处理数据集及预训练模型才能运行:

  • 3DMM文件:下载BFM模型到./deep_3drecon/BFM目录;
  • 预处理数据集:解压数据集(如May数据集)至./data/binary/videos/May
  • 预训练模型:下载audio2motion_vaemotion2video_nerf等模型权重,放置到对应checkpoints目录(如./checkpoints/audio2motion_vae./checkpoints/motion2video_nerf/may_head)。

6. 运行示例测试

设置Python路径并执行推理脚本(替换音频文件路径为实际路径):

# 将项目根目录加入Python路径
export PYTHONPATH=$(pwd):$PYTHONPATH
# 运行推理脚本(示例:将音频生成视频)
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/inference/genefacepp_infer.py --a2m_ckpt=... --drv_aud=/path/to/audio.wav --out_name=/path/to/output.mp4
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

注意事项

  • 依赖兼容性:确保CUDA、cuDNN版本与PyTorch版本匹配(参考PyTorch官网文档);
  • 权限问题:若编译或运行时报权限错误,可尝试在命令前加sudo(但建议优先修复目录权限);
  • 官方文档:若安装过程中遇到问题,优先参考GeneFace++项目的README.md或GitHub Issues页面。
亿速云提供售前/售后服务

售前业务咨询

售后技术保障

400-100-2938

7*24小时售后电话

官方微信小程序