HeyGem.ai 数字人项目更新指南Ubuntu 22.04 官方支持、5090 专属部署与 4 项核心变化速览【免费下载链接】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如果你的本地数字人部署一直卡在只认 Windows、要 100G 硬盘、拉镜像拉半天这一轮更新值得花 5 分钟看完。HeyGem.ai原 Duix.Avatar是一款全离线、免费开源的 AI 数字人本地部署工具——上传约 10 秒视频即可克隆形象与声音用文字或音频驱动生成口播视频全程不联网。当前版本推进到 1.0.6新增了 Ubuntu 22.04 官方支持、NVIDIA 50 系显卡专属镜像以及更轻量的部署组合。核心变化速览这一轮到底改了什么维度变化对用户意味着什么系统Windows 10 独占 → 新增 Ubuntu 22.04 官方支持Linux 用户可用docker-compose-linux.yml部署客户端 AppImage 免安装硬件新增 5090 专属镜像 专属 compose 文件50 系显卡用户不用自己折腾 CUDA/PyTorch 版本部署形态3 个 compose 文件 → 4 种组合full / lite / linux / 5090只做视频合成的用户可跑单服务 lite 版省磁盘省显存客户端界面新增英文国际化修复 #304、#292 等已知问题中英文界面可选老版本常见报错有解部署能力4 种组合按需取用服务端全部以 Docker 镜像提供配置文件集中在 deploy/ 目录首次部署拉取约70GB流量建议连 Wi-Fi 或提前配置镜像源组合文件包含服务开放端口适用用户docker-compose.ymlASR TTS 视频合成3 服务10095 / 18180 / 8383Windows 全功能用户声音克隆视频合成docker-compose-lite.yml仅视频合成1 服务8383已有音频、只做口型合成的轻量用户docker-compose-linux.yml同 full数据目录改为~/duix_avatar_data同上Ubuntu 22.04 用户docker-compose-5090.ymlTTS 视频合成2 服务50 系专属镜像18180 / 8383RTX 50 系用户30/40 系配 CUDA 12.8 也可用磁盘硬性要求C 盘 100G存镜像、D 盘 30G存数据。C 盘不够时可在 Docker 设置里把镜像存储目录改到其他盘硬件能力50 系显卡官方适配50 系Blackwell显卡与旧版 CUDA 环境不兼容官方针对 5090 实测通过了两个新镜像基于 PyTorch 官方预览版 CUDA 12.8# 50 系显卡30/40 系安装 CUDA 12.8 后也可用此方案 cd deploy docker-compose -f docker-compose-5090.yml up -d新镜像guiji2025/duix.avatar-5090、guiji2025/fish-speech-5090老显卡30/40 系维持原docker-compose.yml即可无需升级硬前提不变必须有 NVIDIA 显卡 正确驱动三个服务缺一不可 GPU 启动推荐配置官方验证基线i5-13400F / 32GB 内存 / RTX 4070。社区有 8GB 显存跑通 lite 版的案例但 16GB 以内内存在 ASR 服务上可能吃紧。易用性能力免安装客户端、双语文案、可调试Ubuntu 客户端为 AppImage 单文件双击即用无需安装。root 用户登录桌面时双击可能无效改用终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox界面国际化本轮补充了客户端英文界面src/renderer/i18n/ 下 zh/en 两套文案脚本语言支持 8 种中、英、日、韩、法、德、阿拉伯、西班牙语。本地开放 API服务启动后全部走127.0.0.1方便二次集成能力接口参考代码形象/声音克隆预处理18180/v1/preprocess_and_transrc/main/service/voice.js语音合成TTS18180/v1/invoke同上视频合成提交/查进度8383/easy/submit、8383/easy/querysrc/main/service/video.js日志可自查客户端基于 electron-log 输出 debug/info/warn/error 四级日志单文件上限 2MB、保留 5 份备份src/main/logger.js提 Issue 前先抓日志能省一半沟通成本。实操指南从旧版升到 1.0.6 的 3 步升级不需要数据迁移——克隆的形象、声音和作品都存放在D:\duix_avatar_dataWindows或~/duix_avatar_dataLinux及本地 SQLite 中重新拉镜像即可延续使用。# 1. 服务端重新拉起自动更新镜像 cd deploy docker-compose up -d # 50 系改用 -f docker-compose-5090.yml # 2. 客户端直接下载新版本安装包覆盖安装 # 或从源码构建 git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai npm install npm run build验证Docker 中看到duix-avatar-asr、duix-avatar-tts、duix-avatar-gen-video均为 Runninglite/5090 版服务数量见上表客户端能连上 8383 端口即完成。常见坑速查坑现象解决办法拉镜像超时request canceled while waiting for connection配置国内镜像源在/etc/docker/daemon.json加registry-mirrors镜像源会失效需自行找最新可用C 盘不足 100GDocker 拉取报错/写满在 Docker 设置中把镜像目录换到剩余空间 100G 的盘克隆形象 Connection refused日志出现[Errno 111] Connection refusedASR 连接失败ASR 服务启动慢等服务就绪后等几分钟再操作16G 内存机器可能起不来新增模特报错克隆流程直接失败模特视频必须含人声且在说话声音是克隆的必要输入50 系显卡起不来CUDA 版本冲突换docker-compose-5090.ymlPyTorch 预览版 CUDA 12.8排查时服务端日志可在 Docker 面板中对三个服务分别复制出来选型与适配指南你的环境推荐方案备注Windows 10/11 RTX 30/40 系docker-compose.yml全功能官方主验证路径i5-13400F/32G/RTX 4070 为基线Windows RTX 50 系5090 实测docker-compose-5090.yml2 服务组合专属镜像Windows 只做视频合成docker-compose-lite.yml1 服务最省磁盘显存Ubuntu 22.04 Desktop内核 6.8.0-52 验证docker-compose-linux.yml AppImage需先装 NVIDIA Container Toolkit其他 Linux 发行版 / macOS暂不支持官方明确未做兼容性测试后续规划官方态度是社区活跃、更新频繁短期内没有成型的路线图可以关注两个确定方向更多 Linux 发行版的兼容测试目前只验证了 Ubuntu 22.04实时交互能力仍只存在于官方在线平台开源版定位是非实时视频合成这一点短期不会变遇到新问题优先翻 doc/常见问题.mdIssue 列表每天都在关闭中你的问题大概率已有解。规格速查表旧版 → 1.0.6指标旧版1.0.3 时代当前1.0.6支持系统Windows 10 19042.1526新增 Ubuntu 22.04 Desktop客户端形态Windows 安装包Windows 安装包 AppImage 免安装界面语言中文中文 英文GPU 适配30/40 系老 CUDA新增 50 系专属镜像CUDA 12.8 PyTorch 预览版部署组合固定 3 服务full / lite / linux / 5090 四种首次部署下载量约 70GB约 70GBlite 版更小本地 API8383 / 18180 / 10095不变接口保持兼容结语这一轮更新对用户的实际价值可以压缩成三句话Linux 能用、5090 能装、旧数据不用迁。升级本身只是重新docker-compose up -d加换一个客户端安装包风险很低收益是更宽的平台覆盖和更少的启动报错。git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai/deploy docker-compose up -d项目遵循 Apache 2.0 协议全球免费商用用户量超 10 万或年营收超 1000 万美元的企业需另行签署商业许可见仓库内 Duix.Avatar model community Licensing Agreement。【免费下载链接】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），仅供参考 
长河君 · 2026/9/11 12:29:13 · 阅读 1.2k HeyGem.ai 数字人项目更新指南：Ubuntu 22.04 官方支持、5090 专属部署与 4 项核心变化速览
HeyGem.ai 数字人项目更新指南Ubuntu 22.04 官方支持、5090 专属部署与 4 项核心变化速览【免费下载链接】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如果你的本地数字人部署一直卡在只认 Windows、要 100G 硬盘、拉镜像拉半天这一轮更新值得花 5 分钟看完。HeyGem.ai原 Duix.Avatar是一款全离线、免费开源的 AI 数字人本地部署工具——上传约 10 秒视频即可克隆形象与声音用文字或音频驱动生成口播视频全程不联网。当前版本推进到 1.0.6新增了 Ubuntu 22.04 官方支持、NVIDIA 50 系显卡专属镜像以及更轻量的部署组合。核心变化速览这一轮到底改了什么维度变化对用户意味着什么系统Windows 10 独占 → 新增 Ubuntu 22.04 官方支持Linux 用户可用docker-compose-linux.yml部署客户端 AppImage 免安装硬件新增 5090 专属镜像 专属 compose 文件50 系显卡用户不用自己折腾 CUDA/PyTorch 版本部署形态3 个 compose 文件 → 4 种组合full / lite / linux / 5090只做视频合成的用户可跑单服务 lite 版省磁盘省显存客户端界面新增英文国际化修复 #304、#292 等已知问题中英文界面可选老版本常见报错有解部署能力4 种组合按需取用服务端全部以 Docker 镜像提供配置文件集中在 deploy/ 目录首次部署拉取约70GB流量建议连 Wi-Fi 或提前配置镜像源组合文件包含服务开放端口适用用户docker-compose.ymlASR TTS 视频合成3 服务10095 / 18180 / 8383Windows 全功能用户声音克隆视频合成docker-compose-lite.yml仅视频合成1 服务8383已有音频、只做口型合成的轻量用户docker-compose-linux.yml同 full数据目录改为~/duix_avatar_data同上Ubuntu 22.04 用户docker-compose-5090.ymlTTS 视频合成2 服务50 系专属镜像18180 / 8383RTX 50 系用户30/40 系配 CUDA 12.8 也可用磁盘硬性要求C 盘 100G存镜像、D 盘 30G存数据。C 盘不够时可在 Docker 设置里把镜像存储目录改到其他盘硬件能力50 系显卡官方适配50 系Blackwell显卡与旧版 CUDA 环境不兼容官方针对 5090 实测通过了两个新镜像基于 PyTorch 官方预览版 CUDA 12.8# 50 系显卡30/40 系安装 CUDA 12.8 后也可用此方案 cd deploy docker-compose -f docker-compose-5090.yml up -d新镜像guiji2025/duix.avatar-5090、guiji2025/fish-speech-5090老显卡30/40 系维持原docker-compose.yml即可无需升级硬前提不变必须有 NVIDIA 显卡 正确驱动三个服务缺一不可 GPU 启动推荐配置官方验证基线i5-13400F / 32GB 内存 / RTX 4070。社区有 8GB 显存跑通 lite 版的案例但 16GB 以内内存在 ASR 服务上可能吃紧。易用性能力免安装客户端、双语文案、可调试Ubuntu 客户端为 AppImage 单文件双击即用无需安装。root 用户登录桌面时双击可能无效改用终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox界面国际化本轮补充了客户端英文界面src/renderer/i18n/ 下 zh/en 两套文案脚本语言支持 8 种中、英、日、韩、法、德、阿拉伯、西班牙语。本地开放 API服务启动后全部走127.0.0.1方便二次集成能力接口参考代码形象/声音克隆预处理18180/v1/preprocess_and_transrc/main/service/voice.js语音合成TTS18180/v1/invoke同上视频合成提交/查进度8383/easy/submit、8383/easy/querysrc/main/service/video.js日志可自查客户端基于 electron-log 输出 debug/info/warn/error 四级日志单文件上限 2MB、保留 5 份备份src/main/logger.js提 Issue 前先抓日志能省一半沟通成本。实操指南从旧版升到 1.0.6 的 3 步升级不需要数据迁移——克隆的形象、声音和作品都存放在D:\duix_avatar_dataWindows或~/duix_avatar_dataLinux及本地 SQLite 中重新拉镜像即可延续使用。# 1. 服务端重新拉起自动更新镜像 cd deploy docker-compose up -d # 50 系改用 -f docker-compose-5090.yml # 2. 客户端直接下载新版本安装包覆盖安装 # 或从源码构建 git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai npm install npm run build验证Docker 中看到duix-avatar-asr、duix-avatar-tts、duix-avatar-gen-video均为 Runninglite/5090 版服务数量见上表客户端能连上 8383 端口即完成。常见坑速查坑现象解决办法拉镜像超时request canceled while waiting for connection配置国内镜像源在/etc/docker/daemon.json加registry-mirrors镜像源会失效需自行找最新可用C 盘不足 100GDocker 拉取报错/写满在 Docker 设置中把镜像目录换到剩余空间 100G 的盘克隆形象 Connection refused日志出现[Errno 111] Connection refusedASR 连接失败ASR 服务启动慢等服务就绪后等几分钟再操作16G 内存机器可能起不来新增模特报错克隆流程直接失败模特视频必须含人声且在说话声音是克隆的必要输入50 系显卡起不来CUDA 版本冲突换docker-compose-5090.ymlPyTorch 预览版 CUDA 12.8排查时服务端日志可在 Docker 面板中对三个服务分别复制出来选型与适配指南你的环境推荐方案备注Windows 10/11 RTX 30/40 系docker-compose.yml全功能官方主验证路径i5-13400F/32G/RTX 4070 为基线Windows RTX 50 系5090 实测docker-compose-5090.yml2 服务组合专属镜像Windows 只做视频合成docker-compose-lite.yml1 服务最省磁盘显存Ubuntu 22.04 Desktop内核 6.8.0-52 验证docker-compose-linux.yml AppImage需先装 NVIDIA Container Toolkit其他 Linux 发行版 / macOS暂不支持官方明确未做兼容性测试后续规划官方态度是社区活跃、更新频繁短期内没有成型的路线图可以关注两个确定方向更多 Linux 发行版的兼容测试目前只验证了 Ubuntu 22.04实时交互能力仍只存在于官方在线平台开源版定位是非实时视频合成这一点短期不会变遇到新问题优先翻 doc/常见问题.mdIssue 列表每天都在关闭中你的问题大概率已有解。规格速查表旧版 → 1.0.6指标旧版1.0.3 时代当前1.0.6支持系统Windows 10 19042.1526新增 Ubuntu 22.04 Desktop客户端形态Windows 安装包Windows 安装包 AppImage 免安装界面语言中文中文 英文GPU 适配30/40 系老 CUDA新增 50 系专属镜像CUDA 12.8 PyTorch 预览版部署组合固定 3 服务full / lite / linux / 5090 四种首次部署下载量约 70GB约 70GBlite 版更小本地 API8383 / 18180 / 10095不变接口保持兼容结语这一轮更新对用户的实际价值可以压缩成三句话Linux 能用、5090 能装、旧数据不用迁。升级本身只是重新docker-compose up -d加换一个客户端安装包风险很低收益是更宽的平台覆盖和更少的启动报错。git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai/deploy docker-compose up -d项目遵循 Apache 2.0 协议全球免费商用用户量超 10 万或年营收超 1000 万美元的企业需另行签署商业许可见仓库内 Duix.Avatar model community Licensing Agreement。【免费下载链接】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），仅供参考