
Duix Avatar Linux部署完整指南三步拉起GPU容器生成你的第一条数字人口播视频【免费下载链接】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 是本地离线运行的数字人克隆与口播视频合成工具一段十秒左右、含人声的视频即可克隆出你的形象和声音。本文带你完成 Ubuntu 22.04 下的服务端部署装好驱动与容器依赖、一键拉起三个 GPU 容器、跑通客户端最终合成第一条数字人视频。 项目价值速览能力说明离线数字人克隆形象与声音全部在本地完成约 10 秒带声视频即可建模文字与音频双驱动输入文案或上传音频均可驱动数字人输出视频自动合成口型与语音对齐直接产出成品口播视频多语言脚本覆盖中、英、日、韩、法、德、阿拉伯、西语八种语言 部署前环境自检检查项要求验证方式操作系统Ubuntu 22.04 Desktop内核 6.8.0-52-generic已验证lsb_release -a内存32GB 及以上必要free -hGPUNVIDIA 独显推荐 RTX 4070 及以上nvidia-smi磁盘可用空间 100GB 以上首次拉镜像约 70GBdf -h容器环境Docker 与 Docker Compose 已安装docker --version️ 部署流程阶段一依赖准备目标让系统能装容器并让容器摸到显卡。sudo apt update sudo apt install docker.io docker-compose # 装好容器环境 nvidia-smi # 应显示显卡信息否则先装官方驱动接下来配置 NVIDIA Container Toolkit。要点一句话添加 NVIDIA 官方 apt 仓库并安装 nvidia-container-toolkit用sudo nvidia-ctk runtime configure --runtimedocker把 Docker 切到 NVIDIA 运行时再重启 Docker 服务。验证重新跑nvidia-smi确认驱动正常随后进入下一阶段拉容器时会用到 GPU。阶段二服务端一键拉起目标把 TTS、ASR、视频合成三个 GPU 容器跑起来。git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar # 拿到项目源码 cd Duix-Avatar/deploy docker-compose -f docker-compose-linux.yml up -d # 拉起三个服务 docker ps # 查看容器状态首次启动会下载约 70GB 镜像耗时取决于网速保持网络稳定即可。50 系列显卡用户改用docker-compose-5090.yml启动。验证docker ps中 duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video 三个容器均为 Running。阶段三客户端安装目标装好图形界面连上本地服务。从项目发布页下载 Linux 版 AppImage然后执行chmod x Duix.Avatar-x.x.x.AppImage # 赋予执行权限 ./Duix.Avatar-x.x.x.AppImage # 直接运行无需安装若你是 root 用户进桌面双击可能起不来改为执行./Duix.Avatar-x.x.x.AppImage --no-sandbox。验证界面出现首页能看到我的作品和我的数字模特两个列表即说明客户端已连上本地服务。✅ 验收与首次体验服务就绪的判定很简单三个容器持续 Running没有反复重启。第一次上手走这条路径新建数字模特上传约 10 秒、有清晰人声的视频声音会被用来克隆→ 输入文案或上传音频 → 合成并导出视频。中途卡住或报错先按下一节的顺序自查。 故障排查现象docker-compose up -d拉镜像超时报Client.Timeout exceeded→可能原因Docker Hub 官方源在国内连接不稳定 →处理办法在/etc/docker/daemon.json配置国内镜像源后重启 Docker仓库文档给出的可用源包括https://docker.zhai.cm、https://a.ussh.net、https://hub.littlediary.cn。现象克隆形象时Connection refused→可能原因ASR 服务启动较慢尚未就绪或内存低于 16GB 导致服务起不来 →处理办法服务端刚拉起时等 1~2 分钟再操作内存不足需扩容。现象新建模特提示失败 →可能原因素材视频无声或没有人在说话 →处理办法换一段有清晰人声的视频重新上传。现象三个容器起不来 →可能原因本机没有 NVIDIA 显卡或驱动、NVIDIA 工具包配置缺失 →处理办法回阶段一逐项复查nvidia-smi与容器工具包配置。现象行为异常但原因不明 →可能原因版本过旧问题可能已被修复 →处理办法到deploy目录重新执行docker-compose up -d并查看客户端打开日志与服务端容器日志。 进阶入口服务端启动后在本地暴露了若干端口通过http://127.0.0.1即可调用模型训练、视频合成与音频克隆接口。调用示例直接参考 语音服务源码 中的请求结构常见问题 收录了更完整的报错对照。至此从环境自检到第一条口播视频Linux 上的 Duix Avatar 部署已全部走完。下一步建议先合成一条自己的视频验证全链路效果部署中遇到本文没覆盖的问题查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),仅供参考