3步搭起全离线AI数字人：Duix.Avatar本地部署完整指南

3步搭起全离线AI数字人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是一款真正开源、支持离线视频生成与数字人克隆的 AI 数字人工具箱提交一段约 10 秒的视频形象和声音克隆就完成了之后输入文字或上传音频文件数字人就能开口说话最终产出口型同步的口播视频。这篇指南带你从环境自检、三步部署到故障排查每一步都会告诉你“怎么算成功”。这篇指南写给谁看如果你手边有一台带 NVIDIA 显卡的电脑想制作数字人口播内容又对数据隐私有要求——接下来的内容就是为你准备的。Duix.Avatar 的全部算力都在本地完成部署完成后创作过程不再依赖外网。你的电脑准备好了吗部署前自检清单开工前先花 30 秒对照下面的清单全部打勾再往下走硬件项NVIDIA 显卡且驱动正常终端执行nvidia-smi能看到显卡信息这一项是硬性要求内存 32GB 及以上内存偏小如 16GB可能导致语音识别服务起不来磁盘空间存放 Docker 镜像的磁盘空闲 100GB 以上Windows 上通常是 C 盘存放模型与作品的磁盘空闲 30GB 以上带宽准备首次启动需拉取约 70GB 镜像建议连上稳定的 WiFi软件项Windows 1019042 及以上版本或 Ubuntu 22.04Docker 已安装并运行Windows 需先执行wsl --install再执行wsl --updateNode.js 18 及以上版本如果 C 盘空间紧张可以在 Docker Desktop 的 Settings → Resources 里把 “Disk image location” 通过 Browse 挪到空间更大的磁盘清单全部通过很好进入三步部署。本地数字人最快跑起来3步路径这一节把最小可运行步骤压缩到最少每步只给一条核心命令。第 1 步获取项目源码git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar成功标志当前目录出现Duix-Avatar文件夹里面能看到deploy和src两个目录。第 2 步启动 AI 服务端一次拉起三个服务cd deploy docker-compose up -d首次执行会拉取语音合成、语音识别、视频合成三个镜像视网速大约需要半小时。成功标志Docker 容器列表中duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video三个服务状态均为Running。第 3 步启动客户端npm installnpm run dev也可以直接安装官方预构建的客户端安装包省去这一步。成功标志桌面弹出 Duix.Avatar 窗口首页能看到 “Create Video” 与 “Create Avatar” 两张卡片——如果出现了恭喜你的本地数字人生产线已经跑起来了。它到底能解决哪些场景3个最实用的玩法部署只是开始这个工具箱在日常创作里主要帮你解决三件事。场景一克隆自己的数字人——从一段视频到“数字分身”真实场景你希望有一个能替你出镜、替你念稿的“自己”。怎么操作在首页点击 “Create Avatar”上传一段 10 秒左右、连续说话的视频。得到什么结果外貌与声音被同时克隆新形象出现在 “My Avatars” 列表里之后可反复调用。场景二文字变口播视频——写好稿子直接成片真实场景一篇文案已经就绪需要一条几分钟内产出的口播视频。怎么操作点击 “Create Video”选择克隆好的数字人粘贴文案。得到什么结果系统先把文字转成自然语音再合成口型匹配的数字人画面成片自动进入 “My Works” 列表。文案支持中、英、日、韩、法、德、阿、西 8 种语言。场景三用音频文件直接驱动数字人 ✨真实场景你手头已经有一段录好的高质量语音只想让画面跟着“动起来”。怎么操作在创作流程中选择音频文件输入而不是文本。得到什么结果数字人按音频的节奏和语调生成口型效果比文字转语音更贴近真人。三个场景能顺畅跑通后剩下的就是遇到问题时怎么定位了。启动失败、生成报错怎么办3个常见问题排查部署途中遇到问题很常见先别慌下面三个是最高频的“坑”都按“症状 → 原因 → 解法”讲清楚。问题一拉取镜像超时提示Client.Timeout exceeded症状执行docker-compose up -d后三个服务全部报错日志里能看到 request canceled / 超时字样。原因Docker Hub 官方源连接不稳定不是你的机器出了问题。解法在 Docker Desktop 的 Settings → Docker Engine 配置里加入registry-mirrors填写可用的国内镜像源地址点 Apply restart再重新执行拉取命令即可问题二新增模特失败提示素材无法使用症状提交模特训练视频后直接报错形象没有创建成功。原因创建模特的视频里必须有人在说话——程序要用这段声音做声音克隆纯 BGM 或无声素材都不行。解法在安静环境重录一段 10 秒左右、语句连续的视频再重新提交。问题三克隆形象时报Connection refused症状服务端刚启动就立即定制模特日志出现 funasr 连接异常、Connection refused。原因语音识别服务启动后还需要几分钟预热也可能是机器内存偏小服务本身没有完全跑起来。解法服务端启动后稍等几分钟再操作同时确认三个服务都是 Running 状态。需要进一步定位时点进对应服务点一下日志面板的复制按钮把日志保存下来分析如果以上都没解决可以打开 常见问题文档那里沉淀了更多社区验证过的答案。跑通之后还能做什么3个进阶方向第一条视频产出之后玩法才刚刚开始用 API 接入自己的产品模特训练、音频合成、视频合成都在http://127.0.0.1开放了本地接口src/main/api/ 里的调用代码可以直接当作示例参考。为硬件选对部署版本显存有限的机器可改用 lite 精简版docker-compose -f docker-compose-lite.yml up -dNVIDIA 50 系列显卡则使用专用配置全部文件都在 deploy/ 目录下。迁移到 Linux 服务器Ubuntu 22.04 上换用docker-compose-linux.yml启动服务端配合 AppImage 客户端即可在服务器上完成创作。从自检清单、三步部署到第一支成片你已经完整走通了本地数字人的创作闭环——下次想批量产出内容时打开客户端就可以直接开工。【免费下载链接】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），仅供参考