aixlab-h3

aixlab-h3 是一个独立的 npm 安装器和命令行工具，用来部署本地 ComfyUI + MiniMax H3，并生成带音频的 MP4 视频。

它不会把约 43.2 GiB 的模型权重塞进 npm 包。安装时会从固定的官方版本下载，支持断点续传，并按 SHA-256 逐个校验。默认安装完成后会真的生成一段 5 秒测试视频；只有视频流、音频流、尺寸和时长都通过验收，才会报告 ready。

快速开始

需要 Node.js 20 或更高版本。

npx --yes aixlab-h3@latest doctor
npx --yes aixlab-h3@latest install

安装前会显示 MiniMax H3 许可摘要，并要求用户本人确认完整许可和使用地域。非交互式安装不能替用户做这个决定。

安装完成后生成视频：

npx --yes aixlab-h3@latest generate --landscape --seconds 10 --mode quality --prompt "A spacecraft flying through a sea of clouds, cinematic, high quality"

此版本支持的安装配置

• Windows 10/11 x64 或 Linux x86_64
• NVIDIA GPU，显存至少 23,000 MiB（对应 24 GB 级别显卡）
• 内存至少 48 GiB，建议 64 GiB
• 全新安装至少 60 GiB 可用空间，建议 70 GiB
• Windows 使用官方 ComfyUI v0.34.0 NVIDIA 便携包
• Linux 使用同一 ComfyUI 固定提交、Python 3.12/3.13 和 CUDA 13.0 PyTorch

macOS、ARM64、AMD/Intel GPU、CPU-only 和小于 24 GB 显存不属于本配置支持范围。doctor 会停止安装并说明原因，而不是勉强开始后留下半成品。

已有模型免重复下载

如果本机已有完全相同的六个模型文件，可先让安装器校验，再用硬链接导入：

npx --yes aixlab-h3@latest install `
  --model-source-dir "C:\AI\ComfyUI_windows_portable\ComfyUI\models" `
  --link-models

不在同一磁盘时会改为复制。安装器不会覆盖名称相同但校验不一致的文件。

文档

• 自动化 Agent：AGENT_INSTALL.md
• 人类手把手教程：docs/MANUAL_INSTALL_ZH-CN.md
• 第三方来源与许可：THIRD_PARTY_NOTICES.md
• 固定版本、下载地址、文件大小与 SHA-256：manifests/h3-v1.json

安装器代码使用 MIT License。ComfyUI、MiniMax H3、Qwen 文本编码器和 Turbo LoRA 各自遵循其上游许可；安装器的 MIT License 不会改变模型许可。