Mac 从零运行 H3：纯 C + Metal — MiniMax H3 教程
不用 Python、PyTorch 或 ComfyUI，在 Apple Silicon 上编译 h3.c、检查模型，并生成第一条含声音的 MP4。
适用人群: 有 Apple Silicon Mac、能使用终端，但不想搭建 NVIDIA/ComfyUI 环境的用户。
硬件要求: M 系列 Mac 与足够统一内存、磁盘空间；先跑 512×512、22 帧。不同芯片的速度与可用内存差异很大。
前置条件
- macOS、Git 与 Xcode Command Line Tools
- FFmpeg 和 FFprobe 可从终端直接调用
- 完整 MiniMax-H3 Hugging Face snapshot，目录名设为 MiniMax-H3
- 关闭占用大量统一内存的应用，并为首次载入预留足够时间
执行步骤
- 打开终端运行 xcode-select --install；若已安装会提示无需重复。安装 Homebrew 后执行 brew install ffmpeg，再分别检查 ffmpeg 和 ffprobe 版本。
- 克隆 antirez/h3.c 并进入目录。不要把仓库和模型权重混在同一层散放：教程默认模型完整位于 ./MiniMax-H3。
- 从 Hugging Face 下载 MiniMaxAI/MiniMax-H3 的完整 snapshot 到 ./MiniMax-H3。下载完成后不要改权重文件名，也不要只下载 README 中看起来像主模型的单个文件。
- 执行 make -j8 编译；创建 outputs 目录。若编译失败，先确认当前终端使用的是 Apple clang，并重新检查 Command Line Tools，而不是随意删除编译参数。
- 运行 ./h3 --info -d ./MiniMax-H3。它只核验模型布局并打印 Metal 设备，不会映射全部权重或开始生成；任何缺失文件都应在这一步解决。
- 先运行 512×512、22 帧、20 步的平衡示例。首次启动包含模型载入与文件缓存，不能用第一次总耗时代表稳定速度。
- 如果终端支持图形协议且统一内存充足，可保留 --show 查看中间帧；内存紧张时删除 --show，它会额外占用约 10 GiB 临时模型驻留。
- 确认 outputs/fox-fast.mp4 能播放且含声音。再以相同命令重复一次，第二次耗时才更适合与其他设置比较。
- 需要交互创作时运行 ./h3 -d ./MiniMax-H3 --width 512 --height 512 --steps 6。使用 !status、!seed random、!seconds 2 与 !save output.mp4 管理会话。
- 首尾帧使用 !first opening.png 与 !last ending.png；一般参考图使用 !ref-image person.png。Ref2VA 参考图不能和 !first/!last 同时使用，切换模式前先清理旧条件。
命令
xcode-select --install
brew install ffmpeg
git clone https://github.com/antirez/h3.c && cd h3.c
hf download MiniMaxAI/MiniMax-H3 --local-dir MiniMax-H3
make -j8 && mkdir -p outputs
./h3 --info -d ./MiniMax-H3
./h3 --profile -d ./MiniMax-H3 -p "A red fox walks through fresh snow in a pine forest. Medium tracking shot, natural winter light, realistic fur, soft footsteps and wind." --width 512 --height 512 --frames 22 --steps 20 --layers 45 --reuse 2 -o outputs/fox-fast.mp4
./h3 -d ./MiniMax-H3 --width 512 --height 512 --steps 6
make test
注意事项
- h3.c 正在快速迭代；权重布局、命令参数和性能结论必须以当前 README 为准。
- --show 是可选预览，不是生成所必需；它会增加解码时间和约 10 GiB 临时内存占用。
- 4 步适合极快预览，但细节与运动质量低于 20 步；不要把不同步数结果当同质量比较。
- Apple Silicon 使用统一内存；系统剩余内存不足时，交换与热降频会让结果远慢于公开基准。
查看原始来源 · antirez · 2026-08-23