Duix.Avatar 数字人视频合成工具 v1.0 更新解读NVIDIA 50 系显卡与 Ubuntu 支持怎么部署【免费下载链接】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-AvatarDuix.Avatar现 HeyGem.ai是一款可以在自己电脑上离线运行、把真人视频克隆成数字人并自动生成口播视频的开源工具。本篇解读 v1.0.0 到 v1.0.6 这一阶段的更新这一批版本主要解决三类问题——NVIDIA 50 系显卡如 5090部署报错、Linux/Ubuntu 平台无法使用、以及若干影响日常使用的已知缺陷如 #304、#292。如果你正卡在部署或升级环节这篇文章会告诉你改了什么、要不要升、怎么升、卡住时先看哪里。这次更新先解决什么从 中文 README 的更新公告和 deploy/ 目录的编排文件来看v1.0.6 相比早期 1.0.x 版本实际可用的变化集中在这几件事上NVIDIA 50 系显卡可用了官方说明基于 5090 测试通过。原因是一批新显卡需要更新的 CUDA 环境torch 官方预览版旧镜像起不来。为此新增了专用的编排文件 docker-compose-5090.yml里面换成了duix.avatar-5090和fish-speech-5090两个专用镜像且只需 2 个服务不再单独起 ASR 服务。README 还提示30/40 系列使用 CUDA 12.8 的用户也可以采用这个方案。Ubuntu 22.04 桌面版正式发布完成了 Ubuntu 22.04 Desktop内核 6.8.0-52-generic的适配验证Linux 客户端为 AppImage 单文件形式双击即可启动无需安装。其他 Linux 发行版暂未做兼容性测试。客户端界面支持英文补充了客户端程序的界面国际化英文界面的实现可见 src/renderer/src/i18n/config/en.js。修复已知问题 #304、#292README 未展开细节具体现象以这两个 issue 的讨论为准。更新内容总览变化对谁有用是否必须升级50 系显卡专用部署方案使用 RTX 5090 等新显卡的用户仅 50 系显卡必须Ubuntu 22.04 适配 AppImage 客户端Linux 桌面用户非 Windows 用户必须客户端英文界面非中文环境用户否修复 #304、#292遇到对应问题的用户建议升级lite 单服务编排docker-compose-lite.yml只想做视频合成、不做声音克隆的用户否另外两个长期存在、对新手比较重要的事实也顺带确认一下默认部署会拉起3 个 Docker 服务duix-avatar-tts语音合成、duix-avatar-asr语音识别、duix-avatar-gen-video视频合成定义在 deploy/docker-compose.yml。数据默认写入 Windows 的 D 盘d:/duix_avatar_data/...Linux 下则使用~/duix_avatar_data/...。对新手和普通用户意味着什么如果你是Windows 用户且显卡在 40 系及以下这一版主要是稳定性收益bug 修复 英文界面日常用法没有变化有空时升级即可。如果你是50 系显卡用户以前按默认方案部署大概率失败现在有了官方验证过的方案属于必须升级。如果你是Linux 用户v1.0.6 之前基本没有官方可用的客户端路径现在 Ubuntu 22.04 上可以完整跑通但请注意其他发行版未测试不要自行假定兼容。所有版本都要求NVIDIA 显卡 正确安装的显卡驱动全部算力在本地没有这两项任何部署方案都起不来。升级前需要检查什么硬盘空间以 README_zh.md 为准WindowsC 盘需要 100G 以上空闲存 Docker 镜像D 盘 30G 以上存数字人形象和作品。Ubuntu整机 100G 以上空闲。显卡与驱动执行nvidia-smi能显示显卡信息才算驱动安装正确。内存推荐配置为 32G 及以上常见问题文档提到内存太小如 16G可能导致服务起不来。系统版本Windows 10 19042.1526 或更高版本。首次部署的下载量镜像下载约消耗 70G 流量建议连 Wi-Fi 并预留约半小时等待。快速部署或切换步骤三种部署形态对应 deploy/ 下的三个编排文件按显卡和系统选一个即可。Windows 默认方案3 个服务在deploy目录执行docker-compose up -dDocker Desktop 中出现三个服务容器且状态为 Running 即成功。NVIDIA 50 系显卡方案2 个服务cd deploy docker-compose -f docker-compose-5090.yml up -dUbuntu 22.04 方案3 个服务先装好 Docker、NVIDIA 驱动和 NVIDIA Container Toolkit步骤见 README_zh.md 的Ubuntu22.04 安装一节然后执行cd deploy docker-compose -f docker-compose-linux.yml up -d客户端在 Windows 上双击Duix.Avatar-x.x.x-setup.exe安装包即可Ubuntu 上直接运行Duix.Avatar-x.x.x.AppImage。注意一点root 用户直接双击 AppImage 可能无法运行需要在终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox。常见卡点与排查完整清单在 doc/常见问题.md这里摘取最常遇到的四类docker-compose up -d拉镜像失败报registry-1.docker.io ... request canceledDocker Hub 官方源连接不稳定。解决方式是在 Docker 的daemon.json里配置国内镜像源registry-mirrors配置示例和截图见 常见问题文档。新增模特报错用来创建模特的视频必须有真人说话的声音程序要用这段声音做声音克隆静音视频必然失败。克隆形象时提示Connection refused通常是 ASR 服务duix-avatar-asr启动较慢服务端起来后等几分钟再操作即可如果机器内存只有 16G 左右也可能是服务本身无法启动。tts 服务反复重启可参考 issue #69 的讨论。提问或自查前先确认三件事三个服务是否全部 Running见上图、nvidia-smi是否正常、客户端和服务端是否都是最新版本服务端重新执行docker-compose up -d拉取新镜像即可。新旧版本差异对比项目早期 1.0.xv1.0.6操作系统WindowsWindows Ubuntu 22.04 DesktopLinux 客户端无AppImage 单文件50 系显卡不支持支持5090 实测通过30/40 系 CUDA 12.8 亦可复用客户端语言中文中/英默认服务数 / 轻量方案3 个3 个 / lite 单服务可选已知缺陷#304、#292 等已修复后续可以关注什么50 系方案的适用范围目前说明是经测试 30、40 系 CUDA 12.8 用户也可采用后续若出现更细化的显卡适配说明以仓库最新文档为准。更多 Linux 发行版的适配README 明确其他 Linux 版本暂未测试是否扩展值得关注。API 调用Docker 启动后本地暴露了模特训练18180、视频合成8383等接口想把它接进自己的程序的用户可参考 src/main/service/ 下的model.js、video.js、voice.js三个文件里的调用示例。如果本地部署流程对你来说仍然偏重README 中也提供了云端 API 服务作为对照选项适合不想维护 GPU 环境的用户。想完整走一遍安装建议直接按 README_zh.md 的顺序操作遇到问题优先查 doc/常见问题.md 和仓库 issue 列表你的问题很可能已经有现成答案。【免费下载链接】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），仅供参考