Duix.Avatar Lite：8G显存、单Docker镜像离线生成数字人视频

【免费下载链接】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 是一款离线开源数字人工具：提交一段10秒左右的视频即可完成形象与声音克隆，输入文案或上传音频即可驱动口型，自动生成口播视频。其 Lite 方案把标准版的 3 个 Docker 服务合并为 1 个 gen-video 容器，8G 显存即可运行，模型体积约 10G，不需要 100G 硬盘空间，全程无需联网。

适合谁来跑这套轻量化数字人方案

如果你有一块 8G 以上显存的显卡（比如 RTX 3060、4060），想给短视频配上固定形象的主讲口播，又不打算为 GPU 服务器花钱，这套方案可以直接跑在本机上。它也是内容团队的本地渲染环境：素材和成片不经过云端，适合对素材保密有要求的批量生产。另外，项目已适配 Ubuntu 22.04 Desktop（内核 6.8.0-52-generic），Linux 桌面用户也能本地部署，客户端也补齐了英文界面。

功能总览

数字人口播视频：上传约 10 秒的正面说话视频，克隆出数字模特后，输入文案或直接上传音频，数字人按内容对口型，输出完整口播视频。形象克隆与声音克隆在同一步完成，克隆素材里的声音会被直接复用，所以样片必须是人声。

全离线生成：ASR、TTS、视频合成全部跑在本地 Docker 容器里，生成过程不依赖网络，隐私不出机器。

轻量化部署：标准版是 ASR、TTS、视频合成三个独立容器，Lite 版只用 deploy/docker-compose-lite.yml 启动唯一的 duix-avatar-gen-video 服务，通过 runtime: nvidia 参数直接调用 GPU。

对比项	标准版	Lite 版
容器数量	3 个	1 个
显存要求	推荐 rtx-4070	8G 可用
磁盘占用	约 100G（D盘≥30G）	约 10G 模型，D盘≥30G

8G显存部署数字人的两步做法

第一步：拉起 Lite 服务端。 先装好 Docker Desktop（Windows 需 WSL 支持，确认 C 盘空闲 100G 放镜像、D 盘空闲 30G 存数据），NVIDIA 显卡驱动要正常。然后在项目 deploy 目录执行：

docker-compose -f docker-compose-lite.yml up -d

命令跑完后，Docker 容器列表里出现 duix-avatar-gen-video 且状态为 Running，服务端就部署好了。首次拉取镜像会消耗 70G 左右流量，建议连 WiFi 并耐心等待。

第二步：安装客户端并连接。 下载官方构建的客户端安装包，双击安装后直接打开。客户端自动连接本机 8383 端口，首页看到"Create Avatar"（上传样片克隆模特）和"Create Video"（生成视频）两个入口，就表示链路已通。

实际体验：输入什么，输出什么

输入是一段约 10 秒的正面说话视频。程序用其中的声音做克隆，再用视频里的人脸驱动后续画面。之后只需输入文案（脚本支持中、英、日、韩、法、德、阿拉伯、西八种语言）或上传音频，等待合成，输出就是一条口型对齐的口播视频，全程本地完成。

避坑指南：部署数字人服务的3个高频故障

镜像拉取失败。 症状是 docker-compose up -d 报 Docker Hub 连接超时。原因是官方镜像源在国内不稳定。解决：在 Docker Desktop 的 Docker Engine 设置里添加 registry-mirrors 国内镜像源，再 Apply and restart，重新执行启动命令。

克隆形象报错。 症状是新增模特时程序直接报错。原因是样片没有声音或不是人在说话，而克隆流程依赖这段声音做声音克隆。解决：重拍一段有清晰人声的正面视频再上传。

定制模特提示 Connection refused。 症状是克隆时日志出现 ASR 连接被拒。原因是 ASR 服务启动较慢，服务端刚起来就立刻操作会连不上，机器内存小（如 16G）时更明显。解决：等服务端启动几分钟后再做克隆，并先确认容器为 Running、服务端与客户端都更新到最新版本。更多排查步骤见 常见问题自查。

写在最后

Duix.Avatar Lite 的价值在于把数字人视频生成的门槛压到了一块 8G 显存的显卡加一个 Docker 镜像，离线、免费商用（超大型商用需签署许可协议）。完整部署步骤见 README_zh.md 的"Windows 安装"章节，服务端配置在 deploy/ 目录，遇到新问题可到项目 issue 入口反馈。

【免费下载链接】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