企业官网建设流程全解析

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

你可能看到过"HeiGem.ai"的拼写，官方名字以 HeyGem.ai 为准。它是一套在本机离线跑起来的视频生成工具：用文本和语音驱动虚拟角色出片，全程不用联网，素材也不会离开你的电脑。这篇带你走一遍 HeyGem.ai 本地部署。

🧭 HeyGem.ai 功能速览

HeyGem.ai 是开源的 AI 视频生成工具，值得本地跑的理由很实在：你的照片、录音和成片都留在自己的机器上，不用把个人素材交给第三方云服务。上手后常用的能力有三项：

• 数字形象：上传一张照片加一段语音样本，就能建出对应的虚拟数字人
• 文本转视频：输入一段文字，先合成语音，再让角色把内容"说"出来，直接产出成片
• 多模态输入：纯文本、音频文件、实时录音三种喂料方式都支持，覆盖不同场景

👣 三步让离线视频生成在本地跑起来

1. 把源码拉到本地，一条命令的事：

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

   执行完，当前目录会多出一个 HeyGem.ai 文件夹，后面都在它里面操作。

2. 装依赖，前提是系统里已经装好 Node.js：

   npm install

   这一步会下载不少包，网络稳定时执行更保险；中途断了就重跑一次这一行即可。

3. 验证启动：

   npm run dev

   控制台打出启动成功的信息、界面正常弹出来，就说明环境已经通了。

🐳 Docker 一条命令部署

如果你不想让 Node.js 依赖和一堆配置文件占用系统环境，容器化更省事：

docker-compose up -d

容器在后台跑起来，随时可停可重启，跟你的系统环境互不干扰。仓库的 deploy 目录 里还备了几套不同硬件场景的 compose 配置，需要时替换一下就能用。

⚠️ 踩坑速查与性能微调

第一次部署容易卡住的两个点，对照着处理就行：

跑通之后想再提一提出片体验，记住这三项就够了：

• GPU：有 NVIDIA 显卡的话开启 CUDA 加速，处理耗时会明显缩短
• 内存：按输出分辨率来分，分辨率越高，预留的内存就越大
• 缓存：给缓存目录指定一块独立磁盘，免得空间占满后中途报错

🎬 出片效率指南

想让成片更稳，按这三步走就行：

1. 素材准备：照片清晰、语音干净，建模效果会稳很多
2. 角色创建：先生成数字形象，再围绕它产出想要的内容
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