企业官网建设流程全解析

HeyGem.ai 本地部署指南：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

HeyGem.ai（Duix.Avatar）是一套能完全跑在本地的开源数字人工具：上传一段约 10 秒的真人视频，就能克隆出数字人的形象和声音，之后输入文字或语音，驱动这个形象对口型、自动产出播报视频。整条链路都在你自己的显卡上完成，不依赖云端，素材和数据不出本机。这篇教程按"对齐环境 → 容器起服务 → 客户端出片"的顺序，带你在 3 步内把 HeyGem.ai 本地部署跑通，并在最后给出一套排查方法。

🖥️ 部署前对齐硬件与磁盘条件

本地部署的前提是机器扛得住推理，先对照下面几点，省得中途卡住：

• 显卡：必须有一块 NVIDIA 显卡，并装好对应驱动。项目里所有算力都花在本地，没有显卡或驱动没装好，后面三个服务是起不来的。装完驱动在终端敲nvidia-smi，能看到显卡型号和显存就说明驱动正常。
• 内存与参考配置：内存 32G 起步，参考机型约 i5-13400F + RTX 4070，可按自己情况等量替换。
• 磁盘：Windows 上需要一块 D 盘存数字人、作品等素材，空闲 30G 以上；C 盘用来放 Docker 的镜像文件，空闲 100G 以上。C 盘不够时，可以在 Docker 设置里把磁盘镜像位置改到另一块空间充足的盘。
• 系统：Windows 10 19042 及以上，或 Ubuntu 22.04 桌面版。
• 前置软件：源码方式启动客户端需要 Node.js 18，另外装好 Docker。

🐳 一条命令完成 HeyGem.ai 容器化部署

服务端不用手动装模型，官方把它打包成了三个 Docker 镜像（分别负责语音识别、语音合成、视频合成），拉下来就能用。流程是：

1. 拉取源码并进入项目目录：

   git clone https://gitcode.com/GitHub_Trending/he/HeyGem.ai cd HeyGem.ai

2. 进入 deploy 部署目录，执行docker-compose up -d在后台启动全部服务。首次拉取三个镜像大约消耗 70G 流量、耗时半小时左右，建议连 WiFi 等它下完。

两个可选变体：想更省资源，改用同目录下的docker-compose-lite.yml，它只起一个视频合成服务；用 5090 等 50 系显卡，则改用docker-compose-5090.yml（里面用了适配新显卡的预览版依赖）。

镜像拉得慢时，在 Docker 的 Engine 配置里加一段国内镜像源（registry-mirrors）再重启引擎即可，配法参考下图。

成功标志很简单：在 Docker 的容器列表里看到三个服务都处于 Running 状态，就说明服务端已就绪。

▶️ 安装客户端并生成第一支数字人视频

服务端跑起来后，在客户端操作。拿到源码后执行npm install装依赖（会自动拉取前端所需组件），再执行npm run dev以开发模式启动客户端做验证；如果不想从源码跑，也可以直接下载官方构建好的安装包双击安装。

界面里两个入口对应两件事，按顺序走一遍就能出片：

• Create Avatar（克隆数字人）：上传一段 10 秒左右的真人视频，系统会自动分离画面与音频，克隆出可复用的形象加声音，归到 My Avatars 列表。
• Create Video（生成视频）：选一个已建好的数字人，输入文案或上传音频，数字人就会按内容对口型，生成播报视频存进 My Works。脚本支持中、英、日、韩、法、德、阿、西 8 种语言。

如果只是想在界面里出片，到这里就完成了。想把它接进自己的系统也顺手：Docker 启动后会在127.0.0.1上暴露端口，可分别调用模特训练、音频合成、视频合成三组接口，具体参数见服务端 API 源码。

🔧 卡住或报错时先查这三个位置

本地部署的问题大多集中在这几处，按顺序自查比盲目重装更快：

1. 三个服务是不是都 Running——缺一个或某个在重启，都说明服务端没真正起来。
2. 有没有 NVIDIA 显卡 + 驱动——再确认一次nvidia-smi，这是本地算力的底线。
3. 服务端和客户端是不是都更新到最新——服务端回到 deploy 目录重跑docker-compose up -d，客户端重新 build。

需要看日志时，客户端右上角"打开日志"可打开 logs 目录下的main.log；服务端则点开对应容器的 Logs 面板，找到报错行往上翻即可。更多情况整理在常见问题文档。

现在就打开终端，从git clone开始，把属于你的离线数字人跑起来吧。

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