その他

MacでMLXを使ってオープンソースLLMをローカル実行する手順ガイド

AppleのMLXフレームワークを使えば、Appleシリコン搭載Macでオープンソースの大規模言語モデルをオフラインでローカル実行できます。mlx-lmのインストールからモデル導入、生成、ローカルサーバー起動までの手順を解説します。

一言まとめ

MLXはAppleが公開したオープンソースの機械学習フレームワークで、Appleシリコン搭載Mac(M1以降)でオープンソースのLLMを直接実行できます。本ガイドはインストール、モデル導入、生成、ローカルサーバー起動までの一連の手順を解説します。

適用シーン ​

MacでオープンソースのLLMをローカル実行するのは、プライバシー重視の業務(文書・コードが端末外に出ない)、オフライン環境、低遅延のデバッグとコスト管理(API費用なし)の3つのシーンに適しています。2026年10月16日、MetaはオープンウェイトモデルMuse Spark Openを公開し、Appleと協力して512GBメモリのMac Studio 2台でMLXにより完全モデルをローカル実行し、MLXのローカル推論能力を実証しました。

操作手順 ​

  1. ハードウェアとOSの確認:Appleシリコン搭載Mac(M1/M2/M3/M4シリーズ)、macOS 13以上、Python 3.9以上をインストール。
  2. mlx-lmのインストール:ターミナルで pip install mlx-lm を実行(仮想環境またはuvでの管理を推奨)。
  3. モデルの選択:統合メモリ容量に応じて選択。8GBは3B〜7Bの量子化モデル、32GBは30B級、64GB以上は70B級を実行可能。
  4. モデルのダウンロードと実行:python -m mlx_lm.generate --model mlx-community/Meta-Llama-3.1-8B-Instruct-4bit --prompt "こんにちは" を実行。初回はHugging Faceから自動でウェイトをダウンロード。
  5. ローカルサーバーの起動:python -m mlx_lm.server --model mlx-community/Meta-Llama-3.1-8B-Instruct-4bit --port 8080 を実行し、localhost:8080 でOpenAI互換のAPIを提供。
  6. 自前モデルの量子化:python -m mlx_lm.convert --hf-path モデルディレクトリ -q で4bit量子化版を作成し、メモリ使用量を削減。

注意事項 ​

  • メモリが主要なボトルネック:必要なメモリは「パラメータ数(10億)× 量子化ビット数 ÷ 8」GB程度。7Bモデルの4bit量子化では約4GB必要。
  • 初回はウェイトのダウンロードでネット接続が必要。ダウンロード後はオフラインで利用可能。
  • Muse Spark Open(総パラメータ8160億、活性化420億)は512GBメモリのMac Studioでなければ完全にローカル実行できません。通常のMacは量子化した中小規模モデルに適しています。
  • MLXはAppleシリコン(Mシリーズ)のみ対応。Intel Macでは動作しません。

参考ソース ​