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

数字人技术已不新鲜，但真正能免费、开源、本地部署的方案依然稀缺。Heygem项目正好填补了这块空白——它让你告别付费云服务，在自家电脑上就能批量生成数字人视频。之前我们聊过它的基本能力，这次直接上硬核干货：把整个部署流程拆解清楚，从零开始跑起来。

整体思路

想在本地跑通Heygem，核心就三步走：先装好Docker环境，再从GitHub拉取镜像文件，最后装客户端。下面逐一展开，每一步都是实操经验，照着来基本不会翻车。

安装Docker

Docker是整套系统的底座，安装前需要确认几个前置条件。

1. 环境准备
打开控制面板→程序和功能→启用或关闭Windows功能，勾选“虚拟机平台”。同时，进BIOS确保虚拟化技术（Intel VT-x或AMD-V）处于开启状态。这两个开关缺一不可。设置完成后重启电脑，在任务管理器里确认虚拟化已启用。如果控制面板里的“虚拟机平台”选项始终无法勾选——别折腾，直接重装系统往往是最省事的解法。

2. 软硬件要求
操作系统至少Windows 10以上。推荐配置是13代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，C盘空间紧张的话一定要修改存储路径。进入Docker Desktop的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. 安装
双击安装包，一路点“Next”完成安装。建议安装到非系统盘，避免占用C盘空间。

体验生成数字人视频

一切就绪后，打开客户端，开始第一次实操。

1. 录入模特
准备一段至少8秒的模特视频素材。上传后系统会自动处理、提取面部特征。注意：视频质量直接影响后续效果，尽量用光线均匀、面部无遮挡的素材。

2. 文本驱动：生成数字人视频
选择模特，输入文本内容，点击“合成视频”。等待片刻，就能得到一段由数字人口播的视频。如果生成的视频某些片段不太流畅，很可能是原始模特视频中对应部分不够理想，换一段素材再试即可。

3. 音频驱动：生成数字人视频
同样先选择模特，然后上传一段音频文件（支持常见的语音合成工具输出，比如海螺AI、TTSMaker等）。点击“合成视频”，数字人会按照音频的节奏和语调同步口型。这个功能特别适合已有配音素材的场景。

最后

至此，你已经在本地拥有了一套完全免费、无限次使用的数字人创作工具。从素材准备到视频生成，全流程可控，且数据不出本地。无论是做内容创作、课程录制还是虚拟主播，这个方案都足够扎实。当然，如果你追求更完美的口型同步和面部渲染，后续还可以微调模型参数——但那是进阶玩法了，先把基础流程跑通再说不迟。