LTX2 を M2 Pro Mac mini で動かす

• 概要
• 環境
• インストール
• モデルダウンロード
  • 注意事項
    • gemma3 はライセンスに同意する必要がある
    • distilled は 43GB あるので動かない場合は distilled-fp8 27GB を変わりにダウンロードし使うこと
• 動画生成(通常)
• 動画生成(fp8版)
• 動画生成(fp8版+低メモリ)
• 動画生成(fp8版+低メモリ+fp16フラグ)
• トラブルシューティング
• 最後に
• 参考サイト

概要

MLX 版があるのでそれを使って M2 Pro 上で動作させてみます

環境

• M2 Pro mac mini (16GB)
• macOS 26.4.1
• LTX2-MLX c4f8c44
• Python 3.12.13

インストール

• git clone --depth=1 https://github.com/Acelogic/LTX-2-MLX.git
• cd LTX-2-MLX
• pyenv local 3.12.13
• uv sync --all-groups

モデルダウンロード

• uv run scripts/download_weights.py

注意事項

gemma3 はライセンスに同意する必要がある

• https://huggingface.co/google/gemma-3-12b-it -> Acknowledge license
• huggingface のアカウントが必要
• エラーになった場合は一度 rm -rf weights/gemma-3-12b してから再度 uv run scripts/download_weights.py する

distilled は 43GB あるので動かない場合は distilled-fp8 27GB を変わりにダウンロードし使うこと

• uv run scripts/download_weights.py 実行時に 3 - Custom - Choose individual weights を選択しダウンロードするモデルを個別に選択する

動画生成(通常)

uv run python scripts/generate.py "A realistic cat riding a skateboard on a street, smoothly moving forward, natural motion, full body visible, cinematic lighting, high detail, 4k, camera tracking shot, shallow depth of field" --height 512 --width 512

おそらくこれは M2 Pro mac mini ではエラーになります

動画生成(fp8版)

uv run python scripts/generate.py "A realistic cat riding a skateboard on a street, smoothly moving forward, natural motion, full body visible, cinematic lighting, high detail, 4k, camera tracking shot, shallow depth of field" --height 512 --width 512 --fp8

画像サイズを下げれば何とかこれでもいけるかもしれませんがおそらくこれも不可能です

動画生成(fp8版+低メモリ)

uv run python scripts/generate.py "A realistic cat riding a skateboard on a street" --height 64 --width 96 --fp8 --low-memory --frames 9

おそらくこれでないと M2 Pro mac mini のスペックでは無理かなと思います
画像サイズとプロンプトの長さ、フレーム数も下げています

動画生成(fp8版+低メモリ+fp16フラグ)

uv run python scripts/generate.py "A realistic cat riding a skateboard on a street" --height 64 --width 96 --fp8 --low-memory --frames 9 --fp16 --pipeline one-stage --cfg 5.0

トラブルシューティング

libc++abi: terminating due to uncaught exception of type std::runtime_error: [METAL] Command buffer execution failed: Impacting Interactivity (0000000e:kIOGPUCommandBufferCallbackErrorImpactingInteractivity)

基本的にはメモリ不足が原因です

There appear to be 1 leaked semaphore objects to clean up at shutdown

これもメモリ不足の場合はほとんどです

最後に

LTX2-MLX を M2 Pro mac mini で動かしてみました
何とか動きますが量子化済みのモデルでないと動かないのと生成する動画サイズもかなり小さく短いものでないと無理でした

本当にギリギリなのでもしかしたら環境によっては動かない可能性もあるのでご了承ください

参考サイト

• https://github.com/Acelogic/LTX-2-MLX/blob/main/docs/USAGE.md