HeyGem.ai数字人视频合成服务WSL2部署指南【免费下载链接】Duix-Avatar Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar在 WSL2 里部署 HeyGem.ai 数字人服务最常见的报错是docker-compose up -d执行成功容器却很快退出日志里留下could not select device driver nvidia with capabilities: [[gpu]]——三个合成服务都依赖 GPU容器看不见显卡服务自然起不来。解法并不复杂确认 WSL2 与 Windows 侧的 NVIDIA 驱动让 Docker Desktop 的 GPU 运行时生效再用项目自带 compose 文件把 tts、asr、视频合成三个服务拉起来。完成后三个容器保持 RunningHeyGem.ai 客户端即可连接本地服务合成数字人视频。核对系统与 GPU 前置条件HeyGem.ai 的全部算力都在本地三个 Docker 服务缺一不可地依赖 NVIDIA 显卡。动手之前先对照 README_zh.md 里的要求核对机器配置项目要求说明系统Windows 10 19042.1526 及以上需支持 WSL2NVIDIA 驱动支持 WSL2 GPU 透传的较新版本建议 510.06 及以上用nvidia-smi查看官网下载最新驱动DockerDocker DesktopWSL2 后端GPU 运行时随 Desktop 自动提供内存32G 及以上16G 可能导致 ASR 服务起不来显卡英伟达显卡官方推荐 RTX 4070必须有正确安装的驱动磁盘空闲 100G 以上三个镜像合计约 70G先查驱动版本nvidia-smi预期输出是一张包含 DRIVER VERSION 和显卡型号的表格。版本偏旧就先在 Windows 侧升级驱动WSL2 里用的就是 Windows 安装的驱动不要在发行版内装 Linux 驱动。再查 WSL 版本wsl --list --verbose输出中 VERSION 一列必须是 2。如果显示 1执行升级并更新 WSL 内核wsl --set-version Ubuntu-22.04 2 wsl --update让 Docker Desktop 的 GPU 运行时生效不少人是照着 Linux 教程钻进 WSL 里安装 NVIDIA Container Toolkit——在 WSL2 Docker Desktop 的组合下这一步并不必要。GPU 驱动装在 Windows 侧Docker Desktop 自带 nvidia 运行时并自动注入容器所以发行版内只需要保证两点发行版是 WSL2、Windows 驱动是较新版本。如果你是原生 Ubuntu 22.04 部署则确实需要在发行版内安装驱动、NVIDIA Container Toolkit 并用nvidia-ctk配置 docker 运行时完整步骤见 README_zh.md 的「Ubuntu22.04 安装」一节。拉取镜像并启动三个服务克隆仓库在 deploy 目录直接启动服务git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai/deploy docker-compose up -ddocker-compose.yml 里定义了三个服务声音克隆 ttsfish-speech端口 18180、语音识别 asrfun-asr端口 10095、视频合成 gen-video端口 8383。compose 文件已为每个服务声明runtime: nvidia和设备能力不需要手动传--gpus参数。首次拉镜像约 70G耗时数十分钟建议保持联网耐心等。拉取明显偏慢时跳到下文「高频故障」配置镜像源。如果磁盘空间有限项目还提供了只含一个服务的 docker-compose-lite.yml 精简方案。验证容器能否调用显卡服务拉起来之后别只看docker ps先用测试容器验证整条 GPU 链路docker run --rm --gpus all nvidia/cuda:12.4.1-base-ubuntu22.04 nvidia-smi正常返回示例容器内打印出 nvidia-smi 表格显卡型号与你的物理卡一致。这条命令能跑通说明 WSL2 的 GPU 透传已配置正确跑不通就回到前面两节逐个核对 WSL 版本、驱动版本和 Docker 后端。再确认三个服务的状态docker ps预期duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video均为 Running。最后打开 HeyGem.ai 客户端首页出现「Create Video」与「Create Avatar」两个入口即表示已连上本地服务前者用文本或音频驱动数字人口播后者用约 10 秒的真人视频克隆形象和声音。高频故障与自查命令could not select device driver nvidia容器看不到显卡。依次核对wsl --list --verbose是否为 WSL2、Windows 驱动版本、Docker Desktop 是否使用 WSL2 后端。拉镜像超时Client.Timeout exceededDocker Hub 官方源不稳定在 Docker Desktop 的 Docker Engine 里配置镜像源后重启镜像源清单参考 doc/常见问题.md。克隆形象报Connection refusedASR 服务加载慢服务端启动后等几分钟再操作16G 内存可能起不来建议 32G。新增模特报错模特视频必须含有人说话的声音系统要用这段音频做声音克隆请重新录制。需要提问题单时记得附日志客户端日志在右上角菜单「打开日志」位于%APPDATA%\heygem.ai\logs下的 main.log服务端日志在 Docker 中点开对应容器查看右侧的复制按钮可导出全文。如果你用的是 RTX 50 系列显卡如果是 RTX 50 系列显卡经官方测试部分 30/40 系列 cuda12.8 用户也适用不要用默认 compose 文件改用项目提供的 docker-compose-5090.yml它基于 torch 官方预览版本在 5090 上已测试通过cd deploy docker-compose -f docker-compose-5090.yml up -d如果 C 盘空间不足可以在 Docker Desktop 的 Settings → Resources 里把 Disk image location 改到空闲大于 100G 的磁盘无需重装 Docker。再次遇到容器里那条 GPU 报错时你可以直接沿「WSL 版本、驱动版本、Docker 后端」这条线排查而不是去改合成参数。部署中遇到其他问题可通过仓库 Issue 或技术交流群反馈入群方式见 README_zh.md。下一篇会讲 lite 版与完整版的使用差异。【免费下载链接】Duix-Avatar Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 HeyGem.ai数字人视频合成服务WSL2部署指南
HeyGem.ai数字人视频合成服务WSL2部署指南【免费下载链接】Duix-Avatar Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar在 WSL2 里部署 HeyGem.ai 数字人服务最常见的报错是docker-compose up -d执行成功容器却很快退出日志里留下could not select device driver nvidia with capabilities: [[gpu]]——三个合成服务都依赖 GPU容器看不见显卡服务自然起不来。解法并不复杂确认 WSL2 与 Windows 侧的 NVIDIA 驱动让 Docker Desktop 的 GPU 运行时生效再用项目自带 compose 文件把 tts、asr、视频合成三个服务拉起来。完成后三个容器保持 RunningHeyGem.ai 客户端即可连接本地服务合成数字人视频。核对系统与 GPU 前置条件HeyGem.ai 的全部算力都在本地三个 Docker 服务缺一不可地依赖 NVIDIA 显卡。动手之前先对照 README_zh.md 里的要求核对机器配置项目要求说明系统Windows 10 19042.1526 及以上需支持 WSL2NVIDIA 驱动支持 WSL2 GPU 透传的较新版本建议 510.06 及以上用nvidia-smi查看官网下载最新驱动DockerDocker DesktopWSL2 后端GPU 运行时随 Desktop 自动提供内存32G 及以上16G 可能导致 ASR 服务起不来显卡英伟达显卡官方推荐 RTX 4070必须有正确安装的驱动磁盘空闲 100G 以上三个镜像合计约 70G先查驱动版本nvidia-smi预期输出是一张包含 DRIVER VERSION 和显卡型号的表格。版本偏旧就先在 Windows 侧升级驱动WSL2 里用的就是 Windows 安装的驱动不要在发行版内装 Linux 驱动。再查 WSL 版本wsl --list --verbose输出中 VERSION 一列必须是 2。如果显示 1执行升级并更新 WSL 内核wsl --set-version Ubuntu-22.04 2 wsl --update让 Docker Desktop 的 GPU 运行时生效不少人是照着 Linux 教程钻进 WSL 里安装 NVIDIA Container Toolkit——在 WSL2 Docker Desktop 的组合下这一步并不必要。GPU 驱动装在 Windows 侧Docker Desktop 自带 nvidia 运行时并自动注入容器所以发行版内只需要保证两点发行版是 WSL2、Windows 驱动是较新版本。如果你是原生 Ubuntu 22.04 部署则确实需要在发行版内安装驱动、NVIDIA Container Toolkit 并用nvidia-ctk配置 docker 运行时完整步骤见 README_zh.md 的「Ubuntu22.04 安装」一节。拉取镜像并启动三个服务克隆仓库在 deploy 目录直接启动服务git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai/deploy docker-compose up -ddocker-compose.yml 里定义了三个服务声音克隆 ttsfish-speech端口 18180、语音识别 asrfun-asr端口 10095、视频合成 gen-video端口 8383。compose 文件已为每个服务声明runtime: nvidia和设备能力不需要手动传--gpus参数。首次拉镜像约 70G耗时数十分钟建议保持联网耐心等。拉取明显偏慢时跳到下文「高频故障」配置镜像源。如果磁盘空间有限项目还提供了只含一个服务的 docker-compose-lite.yml 精简方案。验证容器能否调用显卡服务拉起来之后别只看docker ps先用测试容器验证整条 GPU 链路docker run --rm --gpus all nvidia/cuda:12.4.1-base-ubuntu22.04 nvidia-smi正常返回示例容器内打印出 nvidia-smi 表格显卡型号与你的物理卡一致。这条命令能跑通说明 WSL2 的 GPU 透传已配置正确跑不通就回到前面两节逐个核对 WSL 版本、驱动版本和 Docker 后端。再确认三个服务的状态docker ps预期duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video均为 Running。最后打开 HeyGem.ai 客户端首页出现「Create Video」与「Create Avatar」两个入口即表示已连上本地服务前者用文本或音频驱动数字人口播后者用约 10 秒的真人视频克隆形象和声音。高频故障与自查命令could not select device driver nvidia容器看不到显卡。依次核对wsl --list --verbose是否为 WSL2、Windows 驱动版本、Docker Desktop 是否使用 WSL2 后端。拉镜像超时Client.Timeout exceededDocker Hub 官方源不稳定在 Docker Desktop 的 Docker Engine 里配置镜像源后重启镜像源清单参考 doc/常见问题.md。克隆形象报Connection refusedASR 服务加载慢服务端启动后等几分钟再操作16G 内存可能起不来建议 32G。新增模特报错模特视频必须含有人说话的声音系统要用这段音频做声音克隆请重新录制。需要提问题单时记得附日志客户端日志在右上角菜单「打开日志」位于%APPDATA%\heygem.ai\logs下的 main.log服务端日志在 Docker 中点开对应容器查看右侧的复制按钮可导出全文。如果你用的是 RTX 50 系列显卡如果是 RTX 50 系列显卡经官方测试部分 30/40 系列 cuda12.8 用户也适用不要用默认 compose 文件改用项目提供的 docker-compose-5090.yml它基于 torch 官方预览版本在 5090 上已测试通过cd deploy docker-compose -f docker-compose-5090.yml up -d如果 C 盘空间不足可以在 Docker Desktop 的 Settings → Resources 里把 Disk image location 改到空闲大于 100G 的磁盘无需重装 Docker。再次遇到容器里那条 GPU 报错时你可以直接沿「WSL 版本、驱动版本、Docker 后端」这条线排查而不是去改合成参数。部署中遇到其他问题可通过仓库 Issue 或技术交流群反馈入群方式见 README_zh.md。下一篇会讲 lite 版与完整版的使用差异。【免费下载链接】Duix-Avatar Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考