Heygem本地部署零基础教程：快速打造AI数字人

免费开源的本地数字人部署方案仍然稀缺。Heygem项目填补了这一空白：无需付费云服务，在个人电脑上即可批量生成数字人视频。本文聚焦全流程实操部署，从零开始逐步讲解。

整体思路

本地部署Heygem的核心路径：第一步搭建Docker环境，第二步从GitHub拉取镜像，第三步安装客户端。以下逐一拆解，每一步均基于实际测试，按步骤操作可避免常见错误。

安装Docker

Docker作为基础容器平台，安装前需验证以下前置条件。

1. 环境准备
首先启用Windows虚拟机平台：控制面板 → 程序 → 启用或关闭Windows功能，勾选“虚拟机平台”。其次进入BIOS开启CPU虚拟化（Intel VT-x/AMD-V）。两项必须全部开启。重启后通过任务管理器确认虚拟化状态。若控制面板选项无法勾选，建议直接重装系统以避免兼容性问题。

2. 软硬件要求
操作系统要求Windows 10及以上。推荐配置：Intel i5-13400F、32GB内存、RTX 4070显卡。更低配置可运行，但视频生成速度显著下降。

3. 下载Docker安装包
访问Docker官方网站（https://www.docker.com/），点击“Download Docker Desktop”，根据操作系统和CPU架构选择对应版本。下载文件为Docker-Desktop-Installer.exe。

4. 安装与设置
以管理员身份运行安装包，默认选项安装。重启后启动Docker Desktop，首次使用需注册Docker账号。关键：Docker默认镜像存储于C盘，Heygem镜像约80GB，务必修改路径。进入Settings → Resources → Advanced，将镜像存储位置改为空间充足的磁盘。

拉取镜像

拉取镜像前需将项目代码克隆至本地。

1. 获取项目代码
两种方式获取代码：
a) 已安装Git：在终端执行
git clone https://github.com/GuijiAI/HeyGem.ai.git
b) 从GitHub页面下载ZIP压缩包并解压。

2. 拉取镜像并启动
进入项目目录下的deploy文件夹，确保存在docker-compose.yml。在此目录打开终端，执行：
docker-compose up -d
该命令将拉取所有依赖镜像（约82GB），下载时间取决于网络速度。完成后可在Docker Desktop中看到运行的容器和镜像。

客户端安装

1. 下载客户端
在GitHub项目页面Release区域，下载HeyGem-1.0.3-setup.exe安装文件。

2. 安装
双击安装文件，按默认步骤完成安装。建议选择非系统盘路径以节省C盘空间。

体验生成数字人视频

启动客户端，进入首次生成流程。

1. 录入模特
准备一段时长不低于8秒的模特视频。上传后系统自动提取面部特征。提示：视频质量直接决定生成效果，建议使用光线均匀、面部无遮挡的高清素材。

2. 文本驱动：生成数字人视频
选择已录入模特，输入口播文本，点击“合成视频”。等待处理完成即可获得数字人口播视频。若生成视频有不流畅片段，通常源于原始视频对应部分质量不足，更换素材后重试。

3. 音频驱动：生成数字人视频
选择模特后上传音频文件（支持海螺AI、TTSMaker等常见语音合成工具输出）。点击“合成视频”，数字人将根据音频节奏与语调自动同步口型。此功能适用于已有配音内容的场景。

最后

至此，本地已部署完成一套完全免费且无限次使用的数字人创作工具。从素材到生成，全流程本地化，数据安全可控。适用于内容创作、课程录制、虚拟主播等场景。如需优化口型同步与面部渲染，可后续微调模型参数——此为进阶操作，建议先熟练掌握基础流程。

来源：互联网