怎样快速在Windows部署GeneFace++

最快路径 OpenBayes云端一键运行

• 在浏览器打开并登录 OpenBayes，进入 公共教程 → GeneFace++ 数字人 Demo，点击 克隆至本地容器。
• 算力选择 NVIDIA GeForce RTX 4090（新用户通常有免费算力时长），点击 继续执行，等待资源状态变为 运行中。
• 打开工作空间，新建终端，执行：
• conda env export -p /output/geneface
• conda activate /output/geneface
• source bashrc
• 启动 WebUI：运行 /openbayes/home/start_web.sh，看到 “Running on local URL: https://0.0.0.0:8080” 后，将右侧 API 地址 复制到浏览器访问即可使用。
• 说明：该方式无需在本地安装驱动与编译环境，适合 Windows 用户最快体验与演示。

本机部署步骤 Windows 10 64位

• 准备环境
• 安装 Python 3.8/3.9（建议 Anaconda 管理）、Visual Studio Build Tools 2019/2022（勾选 “C++ 桌面开发”）、CUDA Toolkit 与 cuDNN（版本需与 PyTorch 匹配）。
• 更新 NVIDIA 显卡驱动。
• 获取代码与依赖
• 克隆或下载 GeneFace++ 源码；进入项目目录。
• 创建并激活虚拟环境：
• conda create -n geneface python=3.8
• conda activate geneface
• 安装依赖：优先使用项目 requirements.txt；若需手动安装核心包：
• pip install numpy opencv-python torch torchvision
• 编译与安装（如有 C/C++/CUDA 扩展）
• mkdir build && cd build
• cmake .. -G "Visual Studio 16 2019" -A x64 -DPYTHON_EXECUTABLE=pathtopython.exe
• cmake --build . --config Release
• 若提供 Python 安装入口，执行：pip install . 或 python setup.py install
• 运行与验证
• 按项目文档启动：python main.py 或 python webui.py；出现 http://localhost:8080 等提示后，用浏览器访问。
• 提示：若遇到依赖或编译问题，优先对照项目 README 的版本约束与编译说明。

准备与常见问题

• 视频素材建议：3–5 分钟、画面清晰、512×512、纯色背景、人物面部清晰且占比较大、动作幅度适中、音频无杂音，文件名使用英文。
• 环境与版本匹配
• 确保 Python、PyTorch、CUDA/cuDNN 版本匹配；可用 nvcc --version 检查 CUDA 安装；GPU 可用时在代码中使用：
• device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
• 依赖冲突与编译失败
• 使用 虚拟环境 隔离依赖；若报编译错误，确认 VS Build Tools 与 CMake 正确安装并加入 PATH；优先参考项目 requirements.txt 与官方说明。