
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-Avatar数字人视频制作里很多团队卡在同一个问题上商用工具按条收费在线服务又要求素材上云。Duix.Avatar 是开源的离线数字人视频生成与克隆工具整套推理跑在自己电脑的显卡上素材和成片都不出内网。本文按自检 → 部署 → 出片 → 排障的顺序完整演示 Duix.Avatar 本地部署流程照着做完就能产出第一条口播视频。跑通之后你会得到上面这样的桌面客户端两个入口分别负责克隆形象和创建视频数字人与作品列表都保存在本机。部署前自检硬件与软件门槛清单Duix.Avatar 的全部算力都在本地 NVIDIA 显卡上独显缺失或驱动没装好时服务端容器根本起不来。动手前先对照这两组条件。硬件显卡NVIDIA 独显并装好驱动硬性条件推荐配置参考 i5-13400F / 32GB 内存 / RTX 4070内存32GB 及以上16GB 可能拉不起全部服务磁盘镜像与模型至少预留 100GB 空闲另留 30GB 存放数字人与作品数据软件系统Windows 10 19042.1526 以上或 Ubuntu 22.04 桌面版Docker 与 Docker ComposeNode.js 18仅从源码构建客户端时需要直接用官方安装包可跳过有个成本需要心里有数首次启动要拉取约 70GB 镜像耗时约半小时建议用有线或稳定的 WiFi。01 装好 Docker 与 NVIDIA 驱动Windows 路线wsl --updateWSL 是 Docker Desktop 的底层依赖先把它更新到最新。随后从 Docker 官网下载 Docker Desktop 安装首次启动接受协议、跳过登录即可。Windows 上 Docker 默认把镜像存在 C 盘而本项目要求镜像存放位置有 100GB 以上空闲。C 盘不够时打开 Docker 设置 → Resources → Advanced把 Disk image location 指到空间充足的磁盘再重启 DockerUbuntu 22.04 路线docker --version能输出版本号说明 Docker 已就绪可跳过安装否则执行sudo apt install docker.io docker-compose。显卡驱动从 NVIDIA 官网安装后用这条命令验收nvidia-smi显示显卡型号与驱动版本即通过。之后按 NVIDIA 官方文档装好 Container Toolkit执行nvidia-ctk runtime configure --runtimedocker并重启 Docker容器才能真正调用到 GPU。02 一条命令启动服务端三个容器 Running 即就绪先获取代码git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar进入 deploy 目录拉起服务compose 配置deploy/ 目录内按平台区分会自动拉取 fun-asr、fish-speech 和 duix.avatar 三个镜像cd deploy docker-compose up -d下载完成后Docker 中出现 3 个服务且状态均为 Running服务端就算就绪语音识别、语音合成、视频合成各占一个容器。磁盘或流量吃紧时可改用轻量版docker-compose -f docker-compose-lite.yml up -d它只启动视频合成服务但无法完成声音克隆。03 打开客户端从克隆形象到生成第一条口播视频客户端无需编译直接取官方构建包Windows 双击 setup.exe 安装Ubuntu 双击 AppImage 运行若以 root 用户进入桌面后双击无效在终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox启动即可。出片流程分两步克隆形象上传一段 10 秒左右、真人说话的清晰视频。程序会把画面与声音分离分别完成外貌建模和声音克隆。视频必须包含说话声静音素材无法用于声音克隆。生成视频在创建视频中填入文案支持中、英、日、韩等 8 种语言或直接上传音频数字人按内容驱动口型输出与声音同步的口播视频。镜像拉取超时、克隆失败时从哪里查起出问题时多半是环境没到位按这个顺序自查三个服务是否都是 Running只要有一个起不来先执行nvidia-smi确认显卡与驱动正常——缺少 NVIDIA 环境容器必然失败。docker-compose up -d报 connection canceled / context canceledDocker Hub 直连不稳定在 Docker Engine 配置里加入镜像加速器或开启全局代理改完重启 Docker 重新拉取。克隆时报 Connection refused 或 file not existsASR 容器冷启动较慢服务端刚拉起时等几分钟再操作内存低于 16GB 时该服务可能长期无法启动。项目更新频繁服务端在 deploy 目录重跑docker-compose up -d、客户端换成新的构建包不少报错在新版中已修复。需要日志时客户端点右上角 Setting → Open Log 打开本地日志服务端在 Docker 对应容器的 Logs 页复制报错段落再对照 常见问题文档 比对。进阶轻量版部署、50 系显卡与开放 API 调用显存或磁盘紧张使用轻量版 compose上文已给出命令只保留视频合成服务。NVIDIA 50 系显卡5090 已验证30/40 系搭配 CUDA 12.8 也可改用预览版 PyTorch 的部署文件docker-compose -f docker-compose-5090.yml up -d想批量出片或接入自有系统Docker 启动后模型训练、音频合成、视频合成都会暴露在本机http://127.0.0.1的端口上可脚本化调用接口与请求参数可参考 src/main/service/ 下的 model.js、video.js、voice.js。至此克隆、合成、出片整条链路都运行在本机。后续保持服务端重拉镜像、客户端更换构建包即可跟随项目更新同步能力。【免费下载链接】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),仅供参考