路可 踹踹看

MiniMax H3 + ComfyUI 在 Mac 上手動安裝:逐行指令版

· 看影片

這篇是給想自己動手、或安裝器跑不起來的人。操作包裡的安裝器做的事情,拆開來就是下面這幾段指令。照順序在「終端機」一段一段貼上,每段跑完、沒有看到錯誤訊息,再貼下一段。

裝出來的結果和雙擊安裝器一樣:一個獨立資料夾,裡面有 h3.c、一份全新的 ComfyUI、官方 FL2VA 模型和橋接節點。不會動到你原本已經裝好的 ComfyUI。

開始前先確認

  • Apple Silicon(M 系列晶片)的 Mac。Intel Mac 不支援。
  • 至少 230GB 可用空間。模型本身就很大。
  • 裝在外接硬碟的話,硬碟必須是 APFS(Mac 格式),exFAT 不行。
  • 目前只在 M5 Max、64GB 記憶體上實測過,其他機型沒有實測。

第 0 步:前置工具(已經裝過就跳過)

xcode-select --install

這行會安裝 Apple 的 Command Line Tools,提供 git 和 make。跳出視窗後按「安裝」。

Python 需要 3.10 以上,建議 3.12,到 https://www.python.org/downloads/macos/ 下載安裝檔。ffmpeg 要先到 https://brew.sh 裝好 Homebrew,再執行:

brew install ffmpeg

裝完用這三行確認,每行都要印出版本或路徑:

uname -m
python3.12 --version
ffmpeg -version | head -1

第一行必須印出 arm64。如果你裝的是 Python 3.11 或 3.13,後面所有 python3.12 都換成你的版本,例如 python3.11。

第 1 步:建立安裝資料夾,下載操作包

export H3_HOME="$HOME/MiniMax-H3-h3c-ComfyUI"
mkdir "$H3_HOME"
cd "$H3_HOME"
curl -L -o pack.zip https://github.com/trytrylook888/h3c-comfyui-operation-pack/releases/download/v1.0/H3c-ComfyUI-Operation-Pack.zip
unzip -q pack.zip
  • 第一行設定安裝位置。想裝在別處,只要改引號裡的路徑。
  • mkdir 如果說資料夾已經存在,代表你之前裝過,請換一個名字,不要裝進舊資料夾。
  • 後兩行下載操作包並解壓縮。橋接節點和範例工作流都在裡面。

第 2 步:下載並編譯 h3.c

git clone https://github.com/antirez/h3.c.git h3.c
git -C h3.c checkout --detach 8974cc055ea9c02fcd14cc27dfda3e1027c05153
make -C h3.c
ls -l h3.c/h3 h3.c/h3_shaders.metal

h3.c 是在 Mac 上直接跑 MiniMax H3 的程式。第二行把版本固定在操作包測過的那一版,最後一行要看到兩個檔案都存在。

第 3 步:建立獨立的 ComfyUI

git clone https://github.com/Comfy-Org/ComfyUI.git ComfyUI
git -C ComfyUI checkout --detach 88ab4a06566454ad89db8f0bedb970d6c08cd1b7
python3.12 -m venv ComfyUI/.venv
ComfyUI/.venv/bin/python -m pip install --upgrade pip
ComfyUI/.venv/bin/python -m pip install -r ComfyUI/requirements.txt huggingface_hub

第三行建立 ComfyUI 專用的 Python 環境(venv)。後面安裝的套件都只放在這個資料夾裡,不會影響你電腦上其他的 Python。

第 4 步:下載官方 FL2VA 模型

ComfyUI/.venv/bin/hf download MiniMaxAI/MiniMax-H3 --revision 42ed227e --include 'FL2VA/**' --local-dir MiniMax-H3
ls MiniMax-H3/FL2VA/text_encoder MiniMax-H3/FL2VA/transformer

這一步檔案最大,會跑很久,請保持網路和電腦不中斷。中途斷掉的話,重貼同一行就會接著下載。

如果你之前已經下載過官方的 MiniMax-H3 資料夾(裡面有 FL2VA),可以不用重新下載,改成建立連結:

ln -s "/你的路徑/MiniMax-H3" MiniMax-H3

第 5 步(選配):Ref2VA

只要用 FL2VA 的話,直接跳過這一步。Ref2VA 要再下載約 62GB:

H3_MODEL_DIR="$H3_HOME/MiniMax-H3" bash H3c-ComfyUI-Operation-Pack/fetch_ref2va.sh

每個檔案下載完都會核對 SHA-256 校驗碼。中斷的話重貼同一行,會從斷點接著下載。

第 6 步:放入橋接節點與範例工作流

mkdir -p ComfyUI/custom_nodes ComfyUI/user/default/workflows ComfyUI/input ComfyUI/temp
cp -R H3c-ComfyUI-Operation-Pack/comfy_node ComfyUI/custom_nodes/comfy_h3_bridge
cp H3c-ComfyUI-Operation-Pack/workflow_japanese_girl.json "ComfyUI/user/default/workflows/日本女孩 FL2VA Demo.json"
cp H3c-ComfyUI-Operation-Pack/japanese_girl_9grid.png ComfyUI/input/

第 7 步:確認模型讀得到

h3.c/h3 --info -d MiniMax-H3

這行只讀取模型資訊,不會生成影片。印出模型資訊、沒有錯誤訊息,就代表 h3.c 和模型都沒問題。

第 8 步:啟動 ComfyUI

export H3_BINARY="$H3_HOME/h3.c/h3"
export H3_MODEL_DIR="$H3_HOME/MiniMax-H3"
ComfyUI/.venv/bin/python ComfyUI/main.py --listen 127.0.0.1 --port 8188

記憶體低於 48GB 的 Mac,在最後一行之前多貼這一行。它會改成從 SSD 串流模型權重,速度較慢,但比較省記憶體:

export H3_FORCE_SSD_STREAMING=1

看到 ComfyUI 啟動完成後,用瀏覽器打開 http://127.0.0.1:8188 ,在工作流清單選「日本女孩 FL2VA Demo」。如果 8188 已經被其他程式佔用,把指令最後的 8188 改成 8189,網址也跟著改。

之後每次啟動

關掉終端機之後,下次啟動只要貼這一段:

export H3_HOME="$HOME/MiniMax-H3-h3c-ComfyUI"
cd "$H3_HOME"
export H3_BINARY="$H3_HOME/h3.c/h3"
export H3_MODEL_DIR="$H3_HOME/MiniMax-H3"
ComfyUI/.venv/bin/python ComfyUI/main.py --listen 127.0.0.1 --port 8188

記憶體低於 48GB 的話,一樣在最後一行前加上 export H3_FORCE_SSD_STREAMING=1。

卡住的時候

  • xcrun: error 或找不到 git、make:回到第 0 步,裝 Command Line Tools。
  • python3.12: command not found:改成你實際裝的版本,例如 python3.11。
  • 第 4 步中斷:重貼同一行,會接著下載。
  • ComfyUI 裡找不到 H3 節點:確認第 6 步的 cp -R 有成功,而且第 8 步的兩行 export 是在同一個終端機視窗裡貼的。

還是卡住的話,到影片留言區貼上錯誤訊息的最後幾行。