Duix-Avatar 本地部署完整指南克隆专属 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-AvatarDuix-Avatar 是一款全离线运行的 AI 数字人视频生成工具支持在 Windows 和 Ubuntu 上本地部署用一段十几秒的真人视频克隆出你的形象和声音之后输入一段文字或上传一段音频就能驱动这个数字人开口说话、对口型产出口播视频。整个过程素材不离开你的电脑。本文按先把环境跑通 → 再用功能 → 最后接 API的顺序带你从零搭起一套可用的本地数字人生产线。先检查机器这套方案对硬件有什么要求在动手装任何东西之前先确认两个硬性条件否则后面的服务容器会起不来必须有 NVIDIA 显卡且驱动已正确安装。所有推理算力都在本地 GPU 上跑项目文档中明确说明没有英伟达显卡或驱动三个服务容器无法启动。装完驱动后执行nvidia-smi能看到显卡信息才算通过。磁盘空间要留足Windows 下约定用 D 盘存放数字人数据空闲 ≥30GBC 盘存放 Docker 镜像空闲 ≥100GB。推荐配置参考项目说明系统Windows 10 19042.1526 及以上或 Ubuntu 22.04CPU / 内存i5-13400F 级别内存 32GB16GB 可能起不来服务显卡RTX 4070 级别的 NVIDIA 显卡硬盘空闲 ≥100GB网络首次拉镜像流量约 70GB建议用 WiFi第一步获取代码只需一个仓库代码即客户端与部署配置的来源git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar如果你不想装 Docker 全套环境只想体验最核心的视频生成能力仓库里也保留了 lite 版本方案见下文。第二步安装 DockerWindows先备好消息Windows 上 Docker Desktop 依赖 WSL按以下顺序操作wsl --list --verbose查看是否已装 WSL未装则执行wsl --install网络不稳定时多试几次wsl --update更新 WSL从 Docker 官网下载 Windows 版安装包按 CPU 架构选对应版本安装后首次启动接受协议、跳过登录即可。如果 C 盘剩余空间不足 100GB可以在 Docker Desktop 的Settings → Resources → Advanced里把 Disk image location 改到空间更大的磁盘分区Ubuntu 22.04三条命令装 Docker再配好 GPU 直通sudo apt update sudo apt install docker.io sudo apt install docker-composeDocker 要用到 GPU还差一步安装NVIDIA Container Toolkit添加 NVIDIA 仓库 →sudo apt-get install -y nvidia-container-toolkit→sudo nvidia-ctk runtime configure --runtimedocker→sudo systemctl restart docker完整步骤见 README_zh.md 的 Ubuntu 安装章节。第三步一键启动三个服务服务端由 deploy/ 目录下的 docker-compose 编排共三个容器各司其职容器镜像端口职责duix-avatar-asrguiji2025/fun-asr10095语音识别ASRduix-avatar-ttsguiji2025/fish-speech-ziming18180声音克隆与合成TTSduix-avatar-gen-videoguiji2025/duix.avatar8383数字人视频合成对口型进入deploy目录启动cd deploy docker-compose up -d几点说明首次拉镜像耗时约半小时流量约 70GB耐心等磁盘紧张时可用精简版docker-compose -f docker-compose-lite.yml up -d只起视频合成一个容器RTX 50 系显卡30/40 系 CUDA 12.8 也可用专用编排docker-compose -f docker-compose-5090.yml up -d。启动后在 Docker Desktop 里看到三个服务均为 Running 状态即成功点开容器日志能持续刷出运行记录拉镜像超时怎么办国内网络下 Docker Hub 官方源经常连不上报错Client.Timeout exceeded到 Docker Desktop 的Settings → Docker Engine里给守护进程配置registry-mirrors镜像源保存后 Apply restart更多报错与解法收录在 常见问题。第四步安装客户端跑通第一条视频客户端是 Electron 桌面程序负责管理模特、声音和作品Windows下载官方构建的Duix.Avatar-x.x.x-setup.exe安装包双击安装Ubuntu下载Duix.Avatar-x.x.x.AppImage直接运行若以 root 用户登录桌面需在终端加--no-sandbox参数执行。打开客户端界面非常克制上方两个入口Create Video创建视频和Create Avatar创建数字人下方是My Works我的作品和My Avatars我的数字模特两个列表跑通一条完整视频的操作路径是创建模特上传一段 10 秒左右的视频。注意——视频里必须有人、且人在说话程序要分离出画面用于形象克隆、分离出人声用于声音克隆静音视频会直接报错创建视频选择一个模特输入文案支持中、英、日、韩、法、德、阿拉伯、西 8 种语言或直接上传音频提交后任务进入队列轮询完成后作品出现在 My Works 列表可播放、导出。背后发生的事源码在 src/main/service/文字先由 TTS 服务合成音频voice.js再与模特的无声素材视频一起提交给 face2face 服务做口型驱动video.js客户端每 2 秒轮询一次进度并更新状态。进阶不走客户端直接调本地 API服务端启动后会在本机暴露三个接口适合写脚本批量生产数字人视频。参数细节可对照 model.js、voice.js、video.js 里的实际调用代码1. 声音克隆预处理把模特视频的音轨交给 TTS 服务返回后续合成所需的引用信息POST http://127.0.0.1:18180/v1/preprocess_and_tran {format: .wav, reference_audio: xxxx.wav, lang: zh}返回值中的asr_format_audio_url和reference_audio_text要记下来下一步要用。2. 文本转语音POST http://127.0.0.1:18180/v1/invoke {speaker: {uuid}, text: 要合成的文案, format: wav, reference_audio: {上一步返回值}, reference_text: {上一步返回值}}完整固定传参见 README_zh.md 的开放 API 章节3. 视频合成 进度查询POST http://127.0.0.1:8383/easy/submit {audio_url: {音频路径}, video_url: {模特无声视频路径}, code: {uuid}, chaofen: 0, watermark_switch: 0, pn: 1} GET http://127.0.0.1:8383/easy/query?code{taskCode}拿这三个接口串一个循环就是一个最简单的批量数字人视频生成流水线。常见问题 FAQQ1三个容器起不来 / 反复重启先跑nvidia-smi确认 GPU 驱动正常再确认内存 ≥32GB——16GB 内存下 ASR 等容器可能直接起不来。Q2创建模特时报错99% 是上传的视频没有声音、或不是真人在说话见 常见问题 第 2 条。形象克隆和声音克隆都依赖这段视频素材不达标流程走不下去。Q3克隆形象时提示Connection refusedASR 容器duix-avatar-asr冷启动较慢服务端拉起来之后等几分钟再操作即可。Q4出错了日志去哪看客户端右上角设置菜单 → 打开日志在 Roaming 目录的 logs 下查看main.log服务端点开对应的 Docker 容器在 Logs 页复制关键报错Q5端口被占用或客户端连不上服务确认 TTS18180、ASR10095、视频合成8383端口未被其他程序占用客户端默认连http://127.0.0.1配置位置见 config.js。写在最后到这里一台带 N 卡的工作机上已经跑起了一条完整的本地数字人生产线形象克隆、声音克隆、口播合成全部离线完成。先从一段 10 秒的自拍视频开始跑通第一条口播剩下的批量生成、API 集成都是顺手的事了。【免费下载链接】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），仅供参考