Pika Flex 在 Mac 上手動安裝:逐行指令版
照順序在「終端機」一段一段貼上,每段跑完、沒有錯誤訊息,再貼下一段。第 0 步是事前準備,影片裡沒有演;第 1 到第 7 步就是影片第 04 步的 1 到 22 條指令,順序相同。
開始前先確認
- Apple Silicon(M 系列晶片)的 Mac,macOS 14 以上。Intel Mac 不支援。
- 約 150 GB 可用空間。做完後可刪掉
models/base裡的基礎模型,剩約 110 GB。 - 安裝路徑不能有空格,照下面裝在
~/pika-flex-demo即可。 - 目前只在一台 64 GB 記憶體的 Apple Silicon Mac 上實測過。
第 0 步:前置工具
先裝 Apple 的命令列工具(Command Line Tools)。它不是完整的 Xcode App,只是一組終端機用的開發工具,後面會用到其中三個:git 下載引擎和 ComfyUI 的原始碼,make 和 clang 在第 4 步編譯低記憶體生成程式。
xcode-select --install
跳出視窗後按「安裝」。接著把 uv、Python 3.12 和 ffmpeg 裝進家目錄,不需要管理員密碼:
mkdir -p ~/.local/bin ~/Downloads
cd ~/Downloads
curl -fLO \
https://github.com/astral-sh/uv/releases/download/0.12.23/uv-aarch64-apple-darwin.tar.gz
echo "50487ae565ccd96e499056b4674d438f4c53170202617b4c759defe0c6a1b544 uv-aarch64-apple-darwin.tar.gz" \
| shasum -a 256 -c
tar -xzf uv-aarch64-apple-darwin.tar.gz \
--strip-components 1 -C ~/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zprofile
export PATH="$HOME/.local/bin:$PATH"
uv python install 3.12.14
curl -fLO \
https://ffmpeg.martin-riedl.de/download/macos/arm64/1789931890_9.0.2/ffmpeg.zip
curl -fLO \
https://ffmpeg.martin-riedl.de/download/macos/arm64/1789931890_9.0.2/ffprobe.zip
echo "c8ed4c4e6978a03c485edbfe4e0a5dc2380f8a30bba5150531b31b094492d924 ffmpeg.zip" \
| shasum -a 256 -c
echo "fcbe839537485eaee7a7a8bc5cbc0f90d53617e80943e8a5b2e31cb851197ea6 ffprobe.zip" \
| shasum -a 256 -c
unzip -o ffmpeg.zip -d ~/.local/bin
unzip -o ffprobe.zip -d ~/.local/bin
codesign --verify --strict \
~/.local/bin/ffmpeg ~/.local/bin/ffprobe
每個 shasum 都要顯示 OK。用這幾行確認,簽章者應為 TeamIdentifier=KU3N25YGLU:
xcode-select -p
python3.12 --version
codesign -dv ~/.local/bin/ffmpeg 2>&1 | grep TeamIdentifier
ffmpeg -version
第 1 步:下載安裝包,建立資料夾並解壓
在同一個視窗(目前在「下載」資料夾)繼續:
curl -fL -o pika-flex.zip \
"https://drive.google.com/uc?export=download&id=1iE2Tjz6Nh_RlVC3LbVHlMA3rZRe15b4K"
echo "d5c58a817ec3f02511477e8184dfd6a505383c233195d9b9a004f8a236bf2267 pika-flex.zip" \
| shasum -a 256 -c
cd ~
mkdir -p ~/pika-flex-demo
cd ~/pika-flex-demo
unzip ~/Downloads/pika-flex.zip
cd pika-flex
也可以用瀏覽器從下載頁存到「下載」資料夾,一樣要核對指紋。
第 2 步:取得引擎原始碼,裝進獨立環境
git clone \
https://github.com/mrbizarro/minimax-h3-mlx.git h3-engine
git -C h3-engine checkout --detach bef6d03
python3.12 -m venv h3-engine/.venv
h3-engine/.venv/bin/python -m pip install \
-r engine-lock.txt
python3.12 是第 0 步裝的。
第 3 步:讓安裝跑完,確認相依套件沒有衝突
h3-engine/.venv/bin/python -m pip check
第 4 步:編譯低記憶體 sampler 與 decoder
make -C h3-lowmem h3_flex_native h3_decode_video
file h3-lowmem/h3_flex_native \
h3-lowmem/h3_decode_video
最後一行要看到兩個 arm64 執行檔。
第 5 步:取得 ComfyUI,建立它自己的獨立環境
git clone \
https://github.com/Comfy-Org/ComfyUI.git comfyui
git -C comfyui checkout --detach \
fc04da91b2ab12f99e4716371a7e4f98ac982597
python3.12 -m venv comfyui/.venv
第 6 步:裝 ComfyUI 依賴,確認兩個版本
comfyui/.venv/bin/python -m pip install \
-r comfy-lock.txt
git -C h3-engine rev-parse HEAD
git -C comfyui rev-parse HEAD
第 7 步:接上節點,啟動 ComfyUI 確認節點
ln -s ../../comfy-bridge \
comfyui/custom_nodes/pika_flex_mlx
mkdir -p comfyui/user/default/workflows
cp workflows/*.json comfyui/user/default/workflows/
comfyui/.venv/bin/python comfyui/main.py
最後一行會讓 ComfyUI 一直執行,這個視窗不要關。按 ⌘N 另開視窗,確認節點有載入:
curl http://127.0.0.1:8188/object_info
下載模型
在第二個視窗繼續。模型總共約 76 GB:
cd ~/pika-flex-demo/pika-flex
mkdir -p models/shared models/base models/pika-flex-mlx \
tools h3-lowmem/probe_weights/source
curl -fL -C - --retry 5 -o models/shared/text_encoder.safetensors \
https://huggingface.co/ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit/resolve/64314cde0ac6d90f132bc94ae58e0c82f77396c6/text_encoder.safetensors
curl -fL -C - --retry 5 -o models/shared/video_vae.safetensors \
https://huggingface.co/ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit/resolve/64314cde0ac6d90f132bc94ae58e0c82f77396c6/video_vae.safetensors
curl -fL -C - --retry 5 -o models/shared/audio_vae.safetensors \
https://huggingface.co/ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit/resolve/64314cde0ac6d90f132bc94ae58e0c82f77396c6/audio_vae.safetensors
curl -fL -C - --retry 5 -o models/shared/tokenizer.json \
https://huggingface.co/ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit/resolve/64314cde0ac6d90f132bc94ae58e0c82f77396c6/tokenizer.json
curl -fL -C - --retry 5 -o models/shared/tokenizer_config.json \
https://huggingface.co/ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit/resolve/64314cde0ac6d90f132bc94ae58e0c82f77396c6/tokenizer_config.json
curl -fL -C - --retry 5 -o models/base/MiniMax-H3-FL2VA-pruned_bf16.safetensors \
https://huggingface.co/DeepBeepMeep/MiniMax-H3/resolve/d0d3fde21559e905d193f6aeff355cf01cdcaa39/MiniMax-H3-FL2VA-pruned_bf16.safetensors
curl -fL -C - --retry 5 -o models/HMNSFW-AIO-V2.5.safetensors \
https://huggingface.co/Hearmeman/minimax-h3-loras/resolve/e5f4fb9030d1ac27caa0f773b96fbd2d4cafadbb/HMNSFW-AIO-V2.5.safetensors
shasum -a 256 -c <<'EOF'
79514b061aa0acbeb802bbe37e4853f1b0d0e6fe7fad4f61624057201773bf56 models/shared/text_encoder.safetensors
7c1f131492e7eddacaac9069a61b81bdd39de5cc96561e677c5eab1cdce5e522 models/shared/video_vae.safetensors
8e505d95dd1561d47abd43d4238fd40d9bb1ae9e147ed0a4cba778d76ae4db48 models/shared/audio_vae.safetensors
a5d85b6dcc535e6b93115a9ef287e6132fdbf30270da6218194ba742261173c7 models/shared/tokenizer.json
a07e942ac874baa13758de8d1fbdb186683cc03416b5589e1b6671c6b3057c68 models/shared/tokenizer_config.json
85f57a3a7a26def920999f4be786ebb91d0e677ddf327d1848b7724ca829d187 models/base/MiniMax-H3-FL2VA-pruned_bf16.safetensors
a07732a84fd733085eb5d910f602f918fa7a3658117116927e4329f5951a9d2d models/HMNSFW-AIO-V2.5.safetensors
EOF
ln -s ../../../models/shared/video_vae.safetensors \
h3-lowmem/probe_weights/source/model.safetensors
中途斷掉就重貼這一整段,會接著下載,已完成的不會重下(ln 說檔案已存在可以忽略)。shasum 每一行都要 OK。
轉換與融合
curl -fL -o tools/fetch_h3_flex.py \
https://raw.githubusercontent.com/mrbizarro/Phosphene/95715236293b47e033b48b7cfbb578f7043985e4/scripts/fetch_h3_flex.py
echo "0295e51994a332b41b822778a8997fe70aac3eae7a6768475f3d563b0a0a654c tools/fetch_h3_flex.py" \
| shasum -a 256 -c
h3-engine/.venv/bin/python tools/fetch_h3_flex.py \
--dir models/pika-flex-mlx
echo "c71f527d0092dd43d368a20223d4aec41e7a1cca6abecdc457d54cee785f0327 models/pika-flex-mlx/pika_h3_flex_fl2va_phosphene.safetensors" \
| shasum -a 256 -c
h3-engine/.venv/bin/python rename_hm.py \
models/HMNSFW-AIO-V2.5.safetensors models/HMNSFW-AIO-V2.5-mlx.safetensors
echo "e954b26b45a9c5515adf43b9789913d4e7fcbbd1ff1cca1e5c2dedc5bd3f812c models/HMNSFW-AIO-V2.5-mlx.safetensors" \
| shasum -a 256 -c
h3-engine/.venv/bin/python lowmem-fusion/fuse.py \
--base models/base/MiniMax-H3-FL2VA-pruned_bf16.safetensors \
--adapter models/pika-flex-mlx/pika_h3_flex_fl2va_phosphene.safetensors \
--out h3-lowmem/fused-model/flex.safetensors \
--audit h3-lowmem/fused-model/fusion-audit.json
h3-engine/.venv/bin/python lowmem-fusion/verify_fused.py
h3-engine/.venv/bin/python lowmem-fusion/overlay.py \
--base models/base/MiniMax-H3-FL2VA-pruned_bf16.safetensors \
--adapter models/pika-flex-mlx/pika_h3_flex_fl2va_phosphene.safetensors 1.0 \
--adapter models/HMNSFW-AIO-V2.5-mlx.safetensors 0.7 \
--targets-from-last \
--out lowmem-fusion/hm-overlay-0.7/hm.safetensors \
--audit lowmem-fusion/hm-overlay-0.7/audit.json
融合結果在不同晶片上指紋可能不同,所以用 verify_fused.py 核對,mismatches 應為 0。
預檢與第一支影片
h3-engine/.venv/bin/python preflight.py
h3-engine/.venv/bin/python h3-lowmem/run_native_flex.py \
--output runs/first-test --prompt-file h3-lowmem/prompt-cafe.txt
open runs/first-test/flex-lowmem.mp4
預檢要顯示 "status": "passed"。測試片約 4 分鐘生成,能播放、有聲音就代表安裝完成。
在 ComfyUI 生成
用瀏覽器打開 http://127.0.0.1:8188 ,在左側「工作流程」選 Pika-Flex-Low-Memory-Image,在 Load Image 節點選一張自己的圖,按「執行」。成品在 comfyui/output/pika-flex/。HM 是成人向 LoRA,不需要就選「Flex」。
之後每次啟動
cd ~/pika-flex-demo/pika-flex
comfyui/.venv/bin/python comfyui/main.py
卡住的時候
python3.12: command not found:第 0 步那段沒跑完,重貼一次。shasum沒有 OK:不要往下做,刪掉那個檔重新下載。- 第 7 步的
curl連不上:第一個視窗的 ComfyUI 還沒啟動好,或被關了。
還是卡住的話,到影片留言區貼上錯誤訊息的最後幾行。
驗證範圍
- 指令都在一個空白的使用者資料夾裡照順序跑過,全部成功;這不等於全新的 Mac。ComfyUI 生成是透過它的程式介面測的。
- 沒實跑的:
xcode-select --install、播放用的open;最大的兩個模型沒有重新下載,改為核對 Hugging Face 上的指紋相同。