
Duix Avatar Linux部署指南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-AvatarDuix Avatar 是一款完全在本地运行的开源数字人项目上传约 10 秒视频即可克隆形象与声音输入文字或音频就能生成口播视频。本文将带你用 4 步完成 Linux 上的完整部署最终产出第一条数字人视频。先确认能不能跑系统与硬件要求部署前先看一眼下面的配置表。标「必要」的是硬性要求不满足时服务大概率启动不起来。项目硬性要求推荐配置系统Ubuntu 22.04 Desktop官方已测试其他桌面 Linux 发行版可尝试未做兼容性测试显卡NVIDIA 显卡 正确安装的驱动必要RTX 4070 及以上内存32G必要16G 可能启动不了32G 及以上CPU常规多核处理器13代 Intel Core i5-13400F 及以上硬盘—100G 以上空闲首次启动需下载约 70G 镜像运行下面这条自检命令一次性确认 GPU 驱动、Docker、磁盘空间三个前提# 自检查看显卡驱动、Docker 版本、主目录可用空间 nvidia-smi docker --version df -h ~完成判据nvidia-smi输出包含显卡型号和驱动版本的表格docker --version输出版本号没有输出 Docker 没关系第 1 步会装主目录剩余空间大于 100G。部署主流程4 步第 1 步用一条命令安装 Docker 与 Docker Compose本步目的装好容器运行时后面三个数字人服务都跑在容器里。# 从 apt 仓库安装 Docker 与 Docker Compose已安装则跳过 sudo apt update sudo apt install -y docker.io docker-compose成功会看到docker --version与docker-compose version都能输出版本号。第 2 步三条命令配置 Docker 的 GPU 直通本步目的让容器能调用 NVIDIA 显卡项目所有算力都在 GPU 上没有它服务起不来。# 1) 添加 NVIDIA 容器工具包仓库 distribution$(. /etc/os-release;echo $ID$VERSION_ID) \ curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo apt-key add - \ curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list # 2) 安装工具包并配置 Docker 使用 NVIDIA 运行时 sudo apt-get update sudo apt-get install -y nvidia-container-toolkit sudo nvidia-ctk runtime configure --runtimedocker # 3) 重启 Docker 使配置生效 sudo systemctl restart docker成功会看到configure命令无报错且执行docker run --rm --gpus all nvidia/cuda:12.2.0-base nvidia-smi后容器内也能打印出显卡信息。第 3 步克隆仓库用 docker-compose 拉起服务端三个服务本步目的启动语音合成tts、语音识别asr、视频合成gen-video三个后端服务。# 克隆 Duix Avatar 项目 git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar # 用 Linux 版 compose 文件启动服务首次约下载 70G 镜像耗时较长 cd Duix-Avatar/deploy docker-compose -f docker-compose-linux.yml up -d成功会看到docker ps列出 duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video 三个容器状态均为 Running。提示硬盘或显卡余量有限时可改用 deploy/docker-compose-lite.yml只启动视频合成一个服务不含声音克隆。第 4 步下载并启动 Duix Avatar Linux 客户端本步目的安装操作界面后面的克隆和生成都在客户端里点按钮完成。到项目发布页下载 Linux 版本的 AppImage 文件文件名形如 Duix.Avatar-x.x.x.AppImage到任意目录。# 赋予执行权限并启动客户端 chmod x Duix.Avatar-x.x.x.AppImage ./Duix.Avatar-x.x.x.AppImage成功会看到客户端主界面打开能看到「Create Video」和「Create Avatar」两个入口。验证与验收确认数字人生成真的可用用下面 3 个动作确认整个环境工作正常。服务端全绿执行docker ps三个服务tts、asr、gen-video状态都是 Running。客户端连通客户端首页正常加载点击右侧「Create Avatar」能进入上传页没有报错弹窗。产出第一条视频点击「Create Avatar」上传一段 10 秒左右、有你在说话的真人视频处理完成后模型出现在「My Avatars」列表再选择该模型输入一段文字生成口播视频能正常播放即部署完成。避坑速查Duix Avatar 部署最常见的 5 个问题症状解法拉镜像报request canceled/ 连接超时给/etc/docker/daemon.json加registry-mirrors镜像源示例见 doc/常见问题.md再执行sudo systemctl restart docker三个服务启动失败或反复重启先执行nvidia-smi确认驱动再确认第 2 步的工具包已安装且 Docker 已重启定制模特报Connection refusedasr 服务启动较慢服务端启动后等几分钟再试仍报错则检查内存是否达到 32G创建模特报错上传的视频必须有声音且是人在说话程序要用它做声音克隆root 用户下 AppImage 无法启动在终端加参数运行./Duix.Avatar-x.x.x.AppImage --no-sandbox镜像源配置参考下图Linux 下等价于编辑/etc/docker/daemon.json加入相同的registry-mirrors字段进阶入口绕过客户端直接调数字人合成 APIDocker 启动后服务端会在本地暴露 HTTP 接口如 18180 端口处理语音、8383 端口提交视频合成你可以跳过客户端用代码完成模特训练、音频合成与视频合成。接口参数说明见 README_zh.md 的「开放 API」一节相关调用代码在 src/main/service/ 目录下的 model.js、video.js、voice.js。写在最后到这里你拥有一套不依赖外网、形象与数据全部留在本地的数字人环境。后续操作中遇到问题先查 doc/常见问题.md客户端日志可通过右上角「设置 → 打开日志」查看排查问题时用得上。【免费下载链接】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),仅供参考