Duix-Avatar数字人本地部署完整指南：30分钟跑通离线AI视频生成

Duix-Avatar数字人本地部署完整指南30分钟跑通离线AI视频生成【免费下载链接】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 是一套完全开源的AI数字人工具包本地部署后全程离线提交一段10秒左右的视频就能克隆形象和声音再用文字驱动数字人生成AI视频。 它能做什么离线克隆数字人本地合成AI视频是什么全离线数字人工具包覆盖形象/声音克隆、口型驱动、视频合成脚本支持中、英、日等八种语言与常见做法的区别商业SaaS在云端生成、按条计费它全部跑在你本地GPU上断网可用源码可改适合谁内容创作者、虚拟主播以及想接API自建数字人业务的开发者跑通后的直接收益生成不限次数人脸与声音数据不出本机️ 环境预检系统、硬件、前置软件最低要求项目最低要求建议值系统Windows 1019042.1526或 Ubuntu 22.04Windows 10/11 专业版 WSL2硬件英伟达显卡装好驱动、16G内存、100G空闲磁盘RTX 4070、32G内存前置软件Docker Desktop、最新英伟达显卡驱动WSL2 已安装并更新Windows 用户注意必须有 D 盘且空闲 30G 以上存放数字人和作品C 盘空闲 100G 以上存 Docker 镜像。Docker Desktop 右上角齿轮 → Resources在这里查看磁盘镜像位置与内存分配C 盘紧张时用 Browse 把镜像目录换到有空闲 100G 的盘。⚙️ 本地部署流程从克隆代码到服务启动克隆代码确认 deploy 目录完整打开终端执行这条命令git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar验收信号deploy目录下能看到 4 个 compose 文件。docker-compose.yml 是标准版硬件较弱用 docker-compose-lite.yml只起视频合成一个服务50 系显卡用docker-compose-5090.ymlUbuntu 用docker-compose-linux.yml。配置 Docker 镜像源保证拉镜像不超时WindowsDocker Desktop → Docker Engine在配置里加上registry-mirrors列表应用并重启Ubuntu把同样内容写入/etc/docker/daemon.json再重启 Docker 服务镜像源会随时间失效某条不通就换一条或搜最新的。验收信号docker pull不再卡在连接超时镜像能正常下载。启动服务等三个容器全部 Runningcd deploy docker-compose up -d首次启动要下载约 70G 镜像耐心等约半小时建议连 Wi-Fi。验收信号Docker 里 Duix.Avatar-asr、-tts、-gen-video 三个容器全部绿色 Runninglite 版只有 gen-video 一个。 首次使用从用户协议到第一条数字人视频安装官方客户端安装包并启动Windows 是 exeUbuntu 是 AppImage首次运行同意用户协议即可进入工作台。Create Avatar点右侧按钮上传一段 10 秒以上、面部清晰的视频等系统完成形象与声音提取模特就出现在 My Avatars 列表Create Video输入口播文案或上传音频选中刚创建的模特生成完成后成品AI视频出现在 My Works新手最容易卡住的两个地方素材没有说话声—— 克隆会直接报错。声音克隆用的就是素材里的音频选清晰、人在说话的镜头。服务端刚启动就克隆报 Connection refused—— ASR 服务预热慢等服务端启动几分钟后重试内存只有 16G 的机器可能起不来。️ 坑点自查部署高频问题与处理方式docker-compose 启动失败连 Docker Hub 超时现象启动时报registry-1.docker.io连接超时原因官方源网络不稳定处理按上一步加国内镜像源坚持用官方源就先解决网络定制模特报错 Connection refused现象客户端点克隆服务端日志出现Connection refused原因Duix.Avatar-asr 启动慢尚未完全就绪处理等服务端启动几分钟再克隆形象内存 16G 以下建议先升级页面能打开但操作不了先查这三件事现象客户端正常启动但每次操作都失败或超时原因① 三个 Docker 服务未全部 Running ② 没有英伟达显卡或驱动没装 ③ 服务端与客户端版本过旧处理查 Docker 状态 → 跑nvidia-smi确认显卡 → 回deploy目录重新docker-compose up -d更新客户端与服务端日志去哪找现象需要反馈报错却找不到日志原因客户端和服务端日志存放在不同位置处理客户端齿轮 → Open Log文件在AppData\Roaming\heygem.ai\logs下的main.log服务端点进对应 Docker 容器的 Logs 页签复制 延伸入口文档与核心源码doc/常见问题.md —— 自查步骤与报错处理清单适合部署中遇到问题的人src/main/service/video.js —— 视频合成 API 调用流程适合想接本地接口批量生成的人src/main/service/model.js —— 模特训练服务源码适合想改克隆流程的人deploy/docker-compose.yml —— 三个服务的配置文件适合想改端口与数据路径的人三个容器全绿这套工具包就算归你了。后面的每条数字人视频都在你自己的机器上完成。【免费下载链接】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），仅供参考