Linux中GeneFace Plus Plus的安装技巧

Linux下 GeneFace Plus Plus 安装技巧
一 环境准备与版本选择

• 建议使用 conda 创建隔离环境，Python 版本以 3.7–3.9 为宜（不同分支要求略有差异，优先使用仓库 README 指定的版本）。示例：conda create -n geneface python=3.9 -y && conda activate geneface。
• 系统层面安装基础构建工具与图像依赖：sudo yum groupinstall "Development Tools" -y，sudo yum install -y cmake git libpng-devel libjpeg-devel libtiff-devel。
• 提前准备 CUDA/cuDNN 与相匹配的 PyTorch（GPU 版），确保驱动、编译链与深度学习框架版本一致，避免后续导入或运行报错。

二 获取源码与安装依赖

• 克隆项目（以实际仓库为准）：git clone https://github.com/yerfor/GeneFacePlusPlus.git && cd GeneFacePlusPlus。
• 安装 Python 依赖：优先使用项目提供的 requirements.txt，执行 pip install -r requirements.txt；如出现冲突，先升级 pip/conda 再重装。
• 若项目包含需要本地编译的组件，按子模块或脚本指引执行 CMake 构建流程：mkdir build && cd build && cmake .. && make -j$(nproc)（仅在确有本地扩展或 C++/CUDA 算子需要编译时执行）。

三 数据与权重放置

• 按仓库说明下载并放置 3DMM 文件、预处理数据 与 预训练模型权重 到指定目录（常见为 checkpoints/ 等）。目录结构示例：
• checkpoints/audio2motion_vae/
• checkpoints/motion2video_nerf/may_head/
• checkpoints/motion2video_nerf/may_torso/
• 音频测试文件建议放在 data/raw/val_wavs/（文件名与示例脚本保持一致，便于直接运行）。

四 环境变量与路径配置

• 设置 Python 模块搜索路径（在项目根目录执行，或写入 ~/.bashrc 持久化）：export PYTHONPATH=$(pwd):$PYTHONPATH。
• 若编译生成了可执行文件或动态库且不在标准路径，添加至环境变量：export PATH=$PATH:/path/to/bin，export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/lib，并执行 source ~/.bashrc 使其生效。

五 快速验证与常见问题

• 快速验证命令（在项目根目录、环境激活且路径正确时）：

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 为实际 .wav 路径，确保采样率与模型预期一致。

• 常见问题与处理：
• 权限问题：避免全局 sudo pip，优先在用户环境安装；必要时用 sudo 仅限系统级包管理。
• 路径问题：核对 PYTHONPATH、checkpoints 与音频路径是否正确，建议使用绝对路径排除工作目录误差。
• 依赖冲突：升级 pip/conda，必要时新建环境重装依赖；GPU 版需确认 PyTorch + CUDA 版本匹配。
• 系统配置：在部分 CentOS 环境中，可能需要临时关闭 SELinux 或放行防火墙规则以完成安装或首轮运行（完成后按安全策略恢复）。