如何做好Windows部署GeneFace++

Windows部署GeneFace++实操指南
一 环境与硬件准备

• 操作系统与工具
• Windows 10/11 64位（建议）。
• Python 3.8–3.10（建议用 Anaconda/venv 隔离环境）。
• Visual Studio Build Tools 2019/2022（勾选“C++ 生成工具”和 Windows 10/11 SDK），用于编译可能的 C/C++/CUDA 扩展。
• CMake ≥ 3.16（加入系统 PATH）。
• GPU 与驱动（如需加速）
• NVIDIA 显卡与最新 GPU 驱动。
• 安装与 PyTorch 版本匹配的 CUDA Toolkit 与 cuDNN，三者版本需一致；安装后用 nvcc --version 与 nvidia-smi 校验。
• 基础依赖
• 常见依赖包含：numpy、opencv-python、torch、torchvision（以项目 requirements.txt 为准）。

二 两种本地部署路线

• 路线A 源码本地编译（通用）

1. 获取源码：git clone 或下载 ZIP 并解压。
2. 创建并激活虚拟环境：

• conda：conda create -n geneface python=3.9 -y && conda activate geneface
• venv：python -m venv geneface_env && geneface_env\Scripts\activate

1. 安装依赖：pip install -r requirements.txt；如无该文件，先安装核心包（如 numpy、opencv-python、torch、torchvision）。
2. 若有 C++/CUDA 扩展：

mkdir build && cd build
cmake .. -G "Visual Studio 16 2019" -A x64 -DPYTHON_EXECUTABLE=<你的python路径>
cmake --build . --config Release

编译产物按项目说明复制到指定目录（如 src/ 或 site-packages）。

1. 安装 Python 包（若提供）：pip install . 或 python setup.py install。
2. 运行测试：按项目文档执行示例或主程序（如 python main.py、python webui.py）。

• 路线B 云平台容器一键启动（免本地编译，适合快速体验）

1. 登录 OpenBayes，在“公共教程”选择 GeneFace++ 数字人 Demo 并克隆到本地容器。
2. 选择算力（如 NVIDIA GeForce RTX 4090），启动资源后打开工作空间。
3. 在终端激活环境并启动 WebUI：

conda env export -p /output/geneface
conda activate /output/geneface
source bashrc
/openbayes/home/start_web.sh

1. 出现 “Running on local URL: https://0.0.0.0:8080” 后，复制右侧 API 地址 到浏览器访问。

三 关键配置与验证

• 版本匹配与设备选择
• 确保 Python–PyTorch–CUDA/cuDNN 版本匹配；GPU 环境下在代码中设置：

import torch
device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
print("Using:", device)

• 路径与环境变量
• 将可执行文件或库目录加入 PATH（可选）：系统属性 → 高级 → 环境变量 → 系统变量 PATH → 新建路径。
• 快速自检
• 运行项目提供的测试脚本或示例（如 python main.py/python webui.py），确认无缺依赖、无路径错误，日志显示模型/设备加载成功。

四 常见问题与排错要点

• 依赖冲突与安装失败
• 始终在虚拟环境中操作；优先使用项目 requirements.txt；必要时固定版本（如 pip install torch==+cu torchvision ... -c pytorch）。
• 编译错误
• 确认已安装 VS Build Tools 与正确 Windows SDK；CMake 生成时指定正确的 Python 可执行文件路径 与 x64 架构；优先选择 Release 模式编译。
• GPU 不可用或显存不足
• 用 nvidia-smi 与 nvcc --version 检查驱动、CUDA 与显卡状态；显存不足时降低分辨率/批量大小，或改用云平台高显存算力（如 RTX 4090）。
• 无报错但页面打不开
• 检查控制台端口（如 8080）是否被占用；如使用远程/容器环境，确认已映射端口并在浏览器使用正确的 访问地址/API 地址。