Duix.Avatar 本地部署实战3步克隆数字人离线生成口播视频【免费下载链接】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 秒左右的真人视频就能克隆出你的形象和声音之后输入一段文案即可离线生成口播视频。整条链路都在你自己的电脑上跑完不联网、不外传。这篇文章带你从环境检查到跑通生成再到调优和排障。数字人本地生成在做什么可以把它理解成一台装在本地电脑里的数字人直播间三个 Docker 服务各管一段前端客户端负责点选。形象与声音克隆把上传的视频拆成画面和音频用 AI 提取五官、轮廓和音色存成一个可复用的数字模特。文字/语音驱动把文案转成你的克隆音色TTS或直接吃你录的音频。口型合成把驱动音频和模特画面对齐生成口型匹配的成片。这三个环节分别对应服务端的fun-asr、fish-speech-ziming、duix.avatar镜像客户端只是操作入口。一键启动与硬件前置检查跑之前先对一下硬件不达标后面会卡。官方给的建议配置如下配置项官方建议说明系统Windows 10 19042 或 Ubuntu 22.04以官方文档为准显卡NVIDIA 独显 已装驱动硬性要求必需内存32G 及以上必需16G 可能起不来磁盘C 盘空闲 100G、D 盘 30G镜像存 C数据存 D按下面顺序走从克隆仓库到看到客户端界面拉代码进目录git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai预期效果本地出现 HeyGem.ai 目录内含deploy、src等子目录。Windows 先备好 WSL2wsl --install wsl --update预期效果WSL 安装并更新完成Docker Desktop 可正常依赖它。装好 Docker 并确认驱动后启动服务端cd deploy docker-compose up -d预期效果约半小时下载约 70G 流量后Docker 里出现 3 个 Running 的服务即成功lite 版只有 1 个duix.avatar-gen-video。⚠️ 最常见的坑C 盘不足 100G。镜像默认存 C 盘空间不够时要在 Docker 设置里把磁盘镜像位置迁到更大的盘否则后续拉取会直接失败。服务端起来后客户端直接装官方构建的安装包Duix.Avatar-x.x.x-setup.exe双击安装打开即可连接本地服务全程无需联网。核心场景实操服务端和客户端都就位后真正的用法就集中在先有形象、再出视频这条线上。克隆专属数字人形象进入客户端首页点创建数字人形象上传一段约 10 秒、带声音且本人在说话的视频。程序会用它做声音克隆所以素材里必须有真人语音——这一点最容易翻车静音视频会导致克隆直接报错。提交后等待训练完成形象卡片出现在My Avatars里。形象建好之后就可以拿它去出片了。文字驱动生成口播视频切到创建视频选刚克隆的形象粘贴文案或上传一段音频提交后任务就丢给本地的duix.avatar服务离线合成。合成走的是本地 GPU速度取决于显存和磁盘分配成片会进My Works作品列表可预览、导出。进阶与调优跑通之后想更快更稳主要调这三处调优项默认/最低推荐值来源磁盘镜像位置默认 C 盘迁到空间充足的大盘官方建议Docker 内存/CPUWSL2 默认分配按机器给 50% 以上核心官方建议合成分辨率高清低配可降档视显存而定50 系显卡通用 compose改用 5090 专用文件官方建议50 系含部分 30/40 系 CUDA 12.8显卡要用官方预览版 torch 的 compose命令如下cd deploy docker-compose -f docker-compose-5090.yml up -d预期效果以 5090 环境拉起服务避免通用镜像在新显卡上起不来。低配机器建议优先降分辨率、关掉实时预览把显存让给合成服务。高频故障排查现象docker-compose up -d报request canceled、context canceled镜像拉不下来。定位Docker Hub 官方源连不通。解决在 Docker 守护进程配置里加国内registry-mirrors镜像源后重试。现象新增模特时报Connection refused或file not exists。定位点开对应 Docker 服务的 Logs 看栈多为 ASR 服务没就绪。解决duix-avatar-asr启动较慢服务端起来后等几分钟再做克隆内存小于 16G 可能直接拉不起需加内存。现象创建形象失败、提示与声音相关。定位素材问题非环境。解决换成带真人说话的清晰视频重传。排障前记得三件事三个服务是否都 Running、nvidia-smi能否显示显卡、客户端与服务端是否都升到最新版。多数问题在新版里已经修掉。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考