Duix.Avatar 快速部署教程:从零做出第一个数字人口播视频
发布时间:2026/9/11 5:05:31 作者:尧图编辑部 阅读量:1,286

Duix.Avatar 快速部署教程从零做出第一个数字人口播视频【免费下载链接】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 是一个完全离线运行的开源数字人工具上传一段 10 秒左右的说话视频它就能克隆你的形象和声音再输入文案或上传音频即可生成口型匹配的播报视频。本文写给没接触过命令行和容器概念的读者读完后你能把本地三个服务全部跑起来并用客户端做出第一支数字人口播视频。部署前自查硬件与 Docker 先确认项目要求说明系统Windows 1019042.1526 及以上或 Ubuntu 22.04 桌面版其他 Linux 版本官方未验证显卡英伟达显卡并已装好驱动必需项。命令行执行nvidia-smi能显示显卡信息即通过内存32GB 及以上16G 可能导致语音识别服务起不来磁盘空闲空间 100GB 以上存放 Docker 镜像和模型文件预装软件DockerWindows 装 Docker DesktopUbuntu 装 docker 与 docker-compose。docker --version已有输出即可跳过如果 C 盘空闲不足 100GB装好 Docker Desktop 后可以改镜像存放位置Settings → Resources → Disk image location点 Browse 换到空间充足的盘。环境确认好了接下来先解决下载速度。 配置 Docker 镜像加速项目要拉 3 个镜像包合计约 70GB。Docker 默认走国外官方源国内网络很容易中断。解决办法是配置镜像加速源也就是让 Docker 改从国内的转发渠道拉取。点 Docker Desktop 右上角齿轮进设置找到 Docker Engine在页面里的 JSON 加上registry-mirrors字段填入加速源地址然后点 Apply restart。怎么算配好了Docker 重启后后续拉镜像不再出现 request canceled 这类连接中断报错就说明这一步到位了。 拉取项目代码打开命令行Windows 上是 PowerShell进入想存放项目的目录执行git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar命令无报错跑完、当前目录下出现 Duix-Avatar 文件夹说明拉取成功。 启动三个后端服务项目的算力全在三个容器里asr 做语音识别tts 做语音合成gen-video 做视频生成启动配置都在 deploy 目录。执行cd deploy docker-compose up -d首次运行会花半小时左右下载镜像在 Docker Desktop 里能看到下载进度。成功后容器列表里 Duix.Avatar-asr、Duix.Avatar-tts、Duix.Avatar-gen-video 三个服务都是 Running服务端就算就绪。内存紧张的话可改用同目录的 docker-compose-lite.yml 启动精简版只起一个视频生成服务。 安装客户端并确认主页从项目发布页下载官方构建的安装包Windows 版为 Duix.Avatar-x.x.x-setup.exe双击安装即可如果你已有 Node.js 18也可以直接用源码打包。装完双击桌面快捷方式进入主页能看到创建视频和创建数字人两张卡片说明环境已全部就绪。首次上手克隆数字人并生成第一条口播视频服务刚起完先等几分钟asr 服务完全就绪比较慢马上做形象克隆容易报 Connection refused。主页上方紫色卡片是 Create Video用来输入文字或上传音频驱动数字人说话右侧蓝色卡片是 Create Avatar用来上传真人视频创建数字人形象。下方我的作品和我的数字人两个页签分别存放已生成的视频和克隆好的形象。先点 Create Avatar上传一段 10 秒左右、正面说话的清晰视频。注意视频必须带声音轨道且人在说话因为程序要用这段声音做声音克隆。提交后等克隆完成我的数字人页签会出现新的形象卡片。再点 Create Video选中刚建好的数字人输入口播文案或上传音频文件提交合成。完成后口型匹配的口播视频就出现在我的作品里可以直接预览和下载。故障速查高频问题对照表出错先看日志客户端右上角 Setting → 打开日志会直接定位到客户端日志文件 main.log服务端日志则在 Docker Desktop 对应容器的 Logs 页签查看。现象可能原因解决办法docker-compose up -d 报 request canceledDocker Hub 官方源连接中断配置 registry-mirrors 镜像加速Apply restart服务起不来或反复重启无英伟达显卡或驱动未装好nvidia-smi 检查装好驱动后重启 Docker新增数字人失败上传视频无声音或没有人说话重录 10 秒清晰说话的视频再传克隆形象报 Connection refusedASR 服务未就绪或内存不足服务启动后等几分钟再操作内存建议 32G更多边缘问题可参考仓库里的常见问题文档。想再深入的话服务端的形象训练、音频合成、视频合成接口在核心源码里都有现成的调用示例对照着看一遍就能理解整个链路。【免费下载链接】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),仅供参考