Heygem数字人一键整合包

HeyGem（现已更名为 Duix-Avatar）是一款由硅基智能推出的半开源AI数字人项目，旨在提供一个可在本地免费运行的数字人生成方案。该项目并非完全开源，其核心逻辑封装在Docker镜像中，官方原生部署方式对新手有一定门槛。

为了解决部署难题，社区开发者“野鹿志”制作了一键整合包，实现了免安装Docker、解压即用的便捷体验。

项目介绍

项目本质：HeyGem 是一个半开源项目，仅开放了前端界面，核心的数字人生成逻辑被封装在Docker镜像中，未公开源码。

部署难点：官方原生方式需要在Windows上安装Docker并启用WSL2（Windows的Linux子系统），部署流程较为复杂。

整合包优势：本整合包将Docker环境和WSL镜像打包在一起，用户无需手动配置，解压后即可通过启动器自动完成所有环境部署。

整合包使用教程

解压文件：使用 7-Zip 等解压工具，将整合包解压到指定目录。

首次启动：双击运行启动器。程序会自动检测并安装WSL，安装完成后会提示你重启电脑。

再次启动：重启电脑后，再次双击启动器。程序会自动解压并导入WSL镜像，此过程仅在首次运行时出现。

环境检测：程序会自动检测CUDA版本。建议使用12.8及以上版本。若版本过低会提示更新，但12.0至12.8之间的版本仍可继续使用。

打开界面：环境准备就绪后，程序会自动打开WebUI操作界面。

新增功能与优化

整合包在原版基础上进行了多项优化和功能增强：

推理批次：默认值为4，代表每次同时处理4帧画面。显存充足的用户可适当调高此数值以加快生成速度。

分辨率缩放因子：用于降低原视频的分辨率。例如，设置为0.5会将视频缩放至50%。当处理高分辨率视频时，可调低此值以减少显存占用。

    显存建议：对于8G显存的显卡（如GTX 1070），峰值占用约7.8G。若你的显卡为6G显存，建议将推理批次设为2，缩放因子设为0.5。

面部超分：新增面部超分功能，勾选后可在视频生成后自动执行。但效果有限，可能会有轻微失真，追求高质量修复建议使用Topaz Video等专业软件。

音频循环优化：当音频时长超过视频时，原版会简单重复播放。整合包优化为“正放→倒放→正放”的交替循环模式，使过渡更自然。

缓存清理：新增一键清理按钮，可方便地清理temp文件夹中的缓存文件，释放磁盘空间。

端口优化：整合包使用了独立端口，可与 Index-TTS2 等其他整合包同时运行，互不干扰，方便实现“语音克隆+数字人生成”的联动工作流。

卸载与清理

如果后续不再需要使用该整合包，可以执行以下操作彻底清理：

双击运行整合包内附带的“清理WSL”脚本。

根据提示重启电脑。

重启后，可双击“验证WSL”脚本确认环境是否已清理干净。

注意：清理后，若想再次使用，需重新运行启动器，并再次经历完整的安装、解压和导入流程。

来源：酷虎云GPU租赁平台