10秒视频克隆数字人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-AvatarDuix.Avatar 是一款开源 AI 数字人工具包用 10 秒左右的视频就能克隆你的形象和声音输入文案或上传音频即可离线生成口播视频。适合想在自有电脑上本地部署数字人、不想依赖云服务的内容创作者和开发者。部署上手先查磁盘再启服务整套系统分两端服务端跑在 Docker 容器里承担全部算力客户端负责录素材、填文案、看结果。顺序上必须先把服务端容器拉起来客户端才能正常工作。磁盘空间预留动手之前把磁盘留够Docker 镜像和项目数据都会占地方位置要求C盘至少 100GB 空闲存放 Docker 镜像D盘预留 30GB存放项目数据显卡英伟达显卡且驱动装好本地算力全靠它Windows 用户如果走 WSL2先执行wsl --list --verbose确认状态再用wsl --update把内核升到较新版本。服务端容器启动进入 deploy 目录启动即可完整版拉满功能轻量版只保留视频生成服务git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar/deploy docker-compose up -d # 轻量版仅视频生成 docker-compose -f docker-compose-lite.yml up -d⚠️ 注意最常见的翻车是跳过 Docker 直接装客户端——服务没起来客户端什么视频都生成不了装得再快也没用。客户端安装Windows 直接运行Duix.Avatar-x.x.x-setup.exe安装程序Ubuntu 用户在终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox非 root 用户也可以直接双击。界面里就是创建视频和创建数字人两个核心入口上传一段自己出镜说话的视频完成克隆之后填文案就能出片。原理速览看懂三个核心模块不用啃代码也能理解它怎么工作。整条链路拆成三个模块各司其职面部特征提取把 10 秒素材拆成视频帧从里面提取五官、面部轮廓等特征拼出一个 3D 面部模型克隆形象的底子就是它。相关实现在 src/main/dao/f2f-model.js。语音合成把声音克隆和 TTS 结合用你素材里的声音读出新文案听感接近原声。核心代码在 src/main/service/voice.js。视频渲染最后一步把唇形跟音频对齐逐帧合成口播画面支持多分辨率输出。具体逻辑见 src/main/service/video.js。三步串起来就是录 10 秒 → 建形象 → 生成视频的全过程。容器排错速查按现象对号入座本地部署常见问题基本逃不出下面几种按现象直接对照现象docker-compose up -d拉镜像时连接超时、请求被取消。原因Docker Hub 官方源不稳定。解法给 Docker 配置国内镜像加速器改daemon.json加镜像源即可。现象三个服务容器起不来或反复退出。原因机器没有英伟达显卡或驱动没装对——所有算力都在本地。解法先确认 GPU 与驱动再谈部署。现象新增模特时报错。原因素材视频没有声音或者画面里的人没在说话声音克隆没料可用。解法换一段自己清晰出镜讲话的录像重新提交。现象定制模特时报 Connection refused。原因ASR 服务启动慢客户端没等到它就发了请求。解法服务端启动后等几分钟再操作16G 内存的机器可能根本带不动先升级内存。现象端口被占用起不来。原因本机其他程序占了默认端口。解法改 docker-compose.yml 里的端口映射。排查时先确认三个服务都是 Running 状态再看容器日志定位具体报错日志截图配合 doc/常见问题.md 自查步骤基本能覆盖绝大多数情况。适用人群与后续方向现在这套方案最实际的用法有三类自媒体与口播创作者一次录 10 秒素材之后批量生成口播视频更新频率不再被拍摄时间卡住。企业培训与客服把标准化课程和应答内容做成虚拟讲师、虚拟客服减少重复劳动。想自己控制的开发者全程本地化部署人脸和声音数据都留在自己设备里代码可改可扩展。后续方向上官方在往实时互动视频通话、实时字幕与翻译和多模态输入文本、图像、语音混合驱动走但现阶段还是先把离线生成的这条主链路跑稳。跑通一遍之后你会发现部署门槛主要在磁盘和显卡真正耗时的只剩生成等待。遇到具体问题翻官方文档对照日志处理即可。官方文档doc/常见问题.md【免费下载链接】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），仅供参考