Duix-Avatar 安装指南4 步从零跑通离线虚拟形象视频合成【免费下载链接】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 是一款开源的虚拟形象视频合成工具上传一段你说话的录像它能克隆你的长相和音色生成口型对得上的说话视频。整个流程跑在本地不依赖外网素材不会离开你的电脑。本文带你按零基础路线完成安装先体检环境再走部署全程约 40 分钟。环境体检安装前先确认这三件事先看硬件。下表是最低线和舒适线低于最低线的机器直接跑不起来检查项最低要求推荐配置操作系统Windows 1019042 以上或 Ubuntu 22.04Windows 11 / Ubuntu 22.04 桌面版处理器四核 CPUi5-13400F 及以上内存16GB32GB磁盘空间系统盘 100GB 数据盘 30GB 空闲150GB 以上显卡NVIDIA 独显驱动已装好RTX 4070 及以上⚠️ 最容易踩的坑三个服务全靠本地 NVIDIA 显卡算力驱动。没有 N 卡或驱动没装好服务根本起不来集显机器做不了视频合成。软件层面要预装三样各一句话Git—— 拉取项目源码用。Docker Desktop—— 容器化部署 TTS、ASR、视频合成三类服务Windows 下依赖 WSL 子系统。NVIDIA 显卡驱动—— 给容器分配 GPU 算力装完执行nvidia-smi能打印显卡信息即通过。检查完先睹一眼最终效果部署实操Docker 配置分 5 步完成拉取项目源码后续操作都在项目目录里进行先把它拿下来git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar做完后目录里应能看到deploy和src两个文件夹服务编排文件就在 deploy/ 中。检查 WSL 并分配 Docker 资源为什么做Windows 的 Docker 跑在 WSL 上子系统版本过旧会装不上镜像体量大默认磁盘位置空间不足会直接失败。执行wsl --list --verbose查看 WSL没装则先执行wsl --update更新。打开 Docker Desktop点右上角齿轮进入设置。左侧进入Resources → Advanced在Disk image location旁点 Browse把存储路径改到剩余空间 100GB 以上的磁盘。给 WSL 分配至少 8GB 内存、4 个 CPU 核心。点底部Apply restart生效。做完后窗口左下角应显示绿色的 Engine running。配置 Docker 国内镜像源为什么做Docker Hub 官方源拉取经常超时换镜像源能省掉半小时的等待。在设置页左侧点Docker Engine。在 JSON 配置中加入下面一段点Apply restart{ registry-mirrors: [https://docker.1ms.run] }数组里可以多加几个地址做冗余任意一个可用即可。一键启动容器服务为什么做一条命令拉起声音克隆、语音识别、视频合成三个后端。cd deploy docker-compose up -d首次运行要下载镜像和模型流量约 70GB预留 20-40 分钟。机器内存只有 16GB 时改用docker-compose -f docker-compose-lite.yml up -d只起一个合成服务Ubuntu 22.04 用户用 apt 装好 Docker 后在同目录执行docker-compose -f docker-compose-linux.yml up -d。做完后容器页面应显示 3 个 Running 状态的容器。安装桌面客户端为什么做容器是后端大脑客户端才是你操作的界面。到项目官方发布页下载 Windows 安装包。双击Duix.Avatar-x.x.x-setup.exe完成安装。双击桌面快捷方式启动。客户端会自动连上本地三个服务无需额外配置。启动验证怎么判断装好了打开客户端看到首页出现Create Video和Create Avatar两张入口卡片部署就算完成。正式开玩前建议跑一遍冒烟测试点Create Avatar上传一段人在说话、时长 20 秒以上的视频完成第一个形象模型。进入Create Video选中该模型输入一句话文案生成一段 10 秒左右的测试视频。确认新作品出现在 My Works 列表并能正常播放。⚠️ 数据处理全程在本地但仍别处理敏感素材视频合成吃满显卡渲染时关掉其他占资源的应用产出默认存放在d:/duix_avatar_data定期清理。故障速查常见卡点对照表进入deploy目录先查状态和日志docker-compose ps docker-compose logs现象可能原因处理动作容器起不来、秒退无 N 卡或驱动缺失装驱动nvidia-smi验证启动报 registry 连接超时官方源拉取慢配置国内镜像源后重跑创建形象报 Connection refusedasr 服务还在冷启动启动后等 3-5 分钟再试新增模特报错视频无声或无人说话换人在说话的录像重传客户端侧的问题进右上角设置菜单点Open Log日志文件在用户目录logs下的main.log服务端日志则在对应容器的 Logs 页直接看。更多排查步骤见官方自查清单 doc/常见问题.md服务端口18180 / 8383 / 10095与数据目录改法都在 deploy/docker-compose.yml 里。功能导览新手三件套与进阶玩法新手三件套创建第一个虚拟形象—— 上传说话视频系统自动克隆外观和声音。你会看到模型出现在 My Avatars 列表里。文字驱动视频—— 输入文案、选形象和音色一键生成。你会得到一段形象开口说话、口型同步的视频。作品管理—— 生成的视频都落在 My Works随时回放和导出。作品列表会带时间戳实时更新。进阶玩法多模型导入一键切换八国语言文案支持音色参数自定义开放接口二次开发无论是课程录制、产品带货还是短视频口播和培训资料都能在这台本地机器上离线产出。【免费下载链接】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），仅供参考