Heygem 是一款开源本地 AI 数字人平台,旨在最大限度发挥你电脑的硬件潜力,让你无需依赖云端也能高效运行各类开源 AI 模型。无论是语音对话、虚拟主播,还是数字人驱动引擎,Heygem 都能通过底层性能调度与资源优化,为你带来轻量、强大、易上手的 AI 本地化体验。
🚀 Heygem 本地部署教程
一、环境准备
✅ 硬盘空间需求
- C盘:用于存放服务镜像文件,建议预留 至少 100GB 空间。虽然可在 Docker 中指定其他盘符,但部分操作仍可能强制使用 C 盘。
- D盘(必须存在):用于存储数字人素材与生成数据,建议预留 30GB 以上 空间。
✅ 系统要求
- Windows 10(版本号需 ≥ 19042.1526)或更高版本
✅ 推荐硬件配置(越高越流畅)
硬件 | 推荐配置 |
---|---|
CPU | Intel i5-13400F 或等效型号 |
内存 | 至少 32GB(不足易报错) |
显卡 | NVIDIA RTX 4070(建议使用 RTX30/40 系列) |
💡 实测:Intel i7-12700 + RTX 3070,运行表现优异!
✅ 显卡驱动要求
- 需使用 NVIDIA 独立显卡,并确保驱动为最新版本。
- 暂不支持 AMD 显卡。
二、安装 Node.js
前往 Node.js 官网下载并安装最新版:
安装过程无需特别配置,全程“下一步”即可。
🔍 提示:若官网无法访问,可参考文末资料包获取本地安装包。
三、安装 Docker 环境(AI 服务运行核心)
1️⃣ 检查并安装 WSL(Windows 子系统 Linux)
打开命令行,输入:
wsl --list --verbose
- 若已安装,跳过下一步;
- 未安装请执行:
wsl --install
过程中需设置用户名与密码,务必牢记。
2️⃣ 若 WSL 安装失败(常见于网络问题)
编辑 C:\Windows\System32\drivers\etc\hosts
文件,末尾添加:
185.199.108.133 raw.githubusercontent.com
保存后再次运行安装命令。
3️⃣ 更新 WSL:
wsl --update
4️⃣ 安装 Docker Desktop
- 官网下载地址:🔗 Docker 官网
- 安装后首次启动需同意协议,可跳过登录步骤。
🔍 提示:若官网无法访问,可参考文末资料包获取本地安装包。
四、部署 AI 数字人服务端
1️⃣ 下载源码
项目地址:
🔗 Heygem GitHub 仓库
如无法访问 GitHub,可使用文末资料包中的离线版本。
2️⃣ 启动服务端
- 进入
/deploy
目录,确保包含docker-compose.yml
; - 在地址栏输入
cmd
打开命令行,执行:
docker-compose up -d
⚠️ 此过程下载数据量较大(约 70GB),请确保网络稳定。
安装时间取决于网速,通常需半小时以上。
3️⃣ 配置 Docker 加速镜像(提高拉取速度)
打开 Docker 设置 → Docker Engine
,粘贴以下内容:
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"https://docker-0.unsee.tech",
"https://docker-cf.registry.cyou",
"https://docker.1panel.live"
]
}
点击 Apply & Restart,等待镜像拉取完成。
五、安装并体验客户端
1️⃣ 下载客户端
选择最新版 HeyGem-x.x.x-setup.exe
安装包下载。
🔍 提示:若无法访问,可参考文末资料包获取本地安装包。
2️⃣ 安装 & 启动
双击安装包完成安装,桌面将生成快捷方式:
📦 资料包获取
为方便部署体验,作者整理了离线完整资料包:
🔗 点击下载