尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

Duix.Avatar数字人视频生成安装教程:5步本地部署完整上手指南

Duix.Avatar数字人视频生成安装教程:5步本地部署完整上手指南 Duix.Avatar数字人视频生成安装教程5步本地部署完整上手指南【免费下载链接】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 是一款支持本地离线部署的数字人视频生成工具只需一段 10 秒左右的真人视频就能同时克隆你的形象和声音再用文字或音频驱动数字人自动口播全程无需联网。装好之后你可以完成上传素材 → 克隆数字人 → 输入文案生成口播视频的完整流程。本文按自查 → 安装 → 验证 → 排障 → 功能的顺序带你走完全程。环境自查硬件与前置软件先对照下表确认机器配置Duix.Avatar 的全部算力都跑在本地配置直接决定服务能否启动项目最低配置推荐配置操作系统Windows 1019042 及以上版本Windows 11内存16GB32GB 及以上C 盘空闲100GB存放 Docker 镜像100GB 以上D 盘空闲30GB存放数字人与作品数据50GB 以上显卡NVIDIA 显卡必须需装好驱动RTX 4070 或同级需要提前装好的前置软件Git用于获取项目源代码。WSL2 Docker Desktop承载 3 个 AI 后端服务语音识别、语音合成、视频合成。NVIDIA 显卡驱动从 NVIDIA 官网下载装完执行nvidia-smi能看到显卡信息才算成功。⚠️ 注意没有 NVIDIA 显卡或驱动没装好后端三个服务将无法启动集成显卡不在支持范围内16GB 内存可能不足以拉起全部服务建议 32GB。安装主线5 步把服务跑起来第 1 步获取项目源码把项目完整拉到本地后续部署配置都放在deploy/目录里。git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar成功标志进入目录后能看到deploy/、src/、README.md等内容。第 2 步安装并配置 DockerDocker Desktop 是运行后端服务的载体同时要把镜像存储位置指到空间充足的磁盘。先执行下面命令更新 WSL 内核再到 Docker 官网下载 Windows 版安装包首次运行时接受协议、跳过登录即可。wsl --update更新完成、Docker Desktop 左下角显示 Engine running 即安装成功。接着点右上角齿轮图标进入 Settings → Resources → Advanced给 WSL 分配至少 8GB 内存并用 Browse 把磁盘位置改到剩余空间大于 100GB 的磁盘最后点 Apply restart。第 3 步配置镜像加速后端镜像体积较大约 70GB 流量直连官方仓库容易超时提前配置加速源能省掉大量等待时间。在 Docker Desktop 设置中打开 Docker Engine在 JSON 配置里加入registry-mirrors字段填入可用的国内加速地址点 Apply restart 生效。第 4 步启动 3 个 AI 后端服务这是最关键的一步在部署目录里启动 TTS、ASR、视频合成三个容器首次运行会拉取全部镜像。cd deploy docker-compose up -d耐心等待约 20–30 分钟取决于网速建议连 WiFi成功后 Docker Desktop 的容器列表中duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video三个服务全部显示 Running。显存吃紧时可用轻量方案只启动视频合成服务docker-compose -f docker-compose-lite.yml up -d第 5 步安装客户端客户端是操作界面到项目 release 页下载官方构建的 Windows 安装包双击Duix.Avatar-x.x.x-setup.exe按向导安装。安装完成、桌面出现 Duix.Avatar 图标即可进入验证环节。跑起来验证打开界面并生成第一条视频启动客户端看到Create Video创建视频与Create Avatar创建形象两个入口下方有我的作品 / 我的数字人列表说明客户端与本地服务已正常连通。快速体验两条核心路径克隆数字人点击 Create Avatar上传一段约 10 秒、画面中人物在说话且带声音的视频等待 1–2 分钟我的数字人里就会出现你的克隆形象。生成口播视频点击 Create Video选择刚创建的数字人输入一段文字提交后在我的作品中查看生成的口播视频。⚠️ 注意用于创建模型的素材视频必须包含真人说话的声音静音或无人声的素材会直接报错这是新手最常见的失败原因。问题速查启动失败的快速自查现象可能原因解决方法拉镜像报 request canceled / 连接超时Docker Hub 官方源连接不稳定按第 3 步配置 registry-mirrors 加速源后重启克隆形象时报 Connection refusedASR 服务启动较慢约需几分钟或内存不足16G 可能起不来服务启动后等几分钟再操作内存升级到 32GB三个服务全部起不来无 NVIDIA 显卡或驱动未装好安装驱动并执行nvidia-smi验证新增模特报错素材视频无声音或无人说话重新录制 10 秒带人声的说话视频深入排查时看两处日志客户端点右上角设置 → 打开日志在 logs 目录打开main.log服务端在 Docker Desktop 中点开对应容器切到 Logs 页签查看并复制关键报错。使用建议数据安全全部计算本地离线完成不会上传云端但仍不建议克隆敏感人物素材。性能视频生成期间 GPU 占用很高建议关闭其他大型应用。存储生成视频存放在 D 盘duix_avatar_data目录文件较大定期清理不再需要的作品。功能预览与收尾马上能用的上传 10 秒视频一键克隆真人形象与声音。输入文字即可驱动数字人自动生成口型同步的口播视频。我的作品 / 我的数字人集中管理多模型一键切换。文案支持中、英、日、韩、法、德、阿拉伯、西语共 8 种语言。进阶能力开放本地 API端口 18180 / 8383可接入自己的业务系统参考 src/main/service/ 下的 model.js、video.js、voice.js。lite 单镜像方案显存 8GB 即可运行视频合成。NVIDIA 50 系列显卡可用deploy/下的docker-compose-5090.yml单独部署。到这里Duix.Avatar 的安装与第一次视频生成已经完成更多细节可查看 doc/常见问题.md部署参数都在 deploy/ 目录中随时按你的机器配置调整。【免费下载链接】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),仅供参考
返回列表