> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/jp/moderu/minimax-m3.md).

# MiniMax M3 - ローカルでの実行方法

MiniMax M3は新しい **約428B（23Bがアクティブ）** コーディング、エージェント的ワークフロー、共同作業タスク、マルチモーダルチャット向けのオープンモデルです。マルチモーダルモデルはテキスト、画像、動画入力をサポートしており、 **100万トークンのコンテキスト** **ウィンドウ**。量子化されていないbf16重みは約**855GB** そして1ビットGGUFではこれがわずか **128GB（-85%）**: [**MiniMax-M3 GGUF**](https://huggingface.co/unsloth/MiniMax-M3-GGUF)

このモデルはGemini 3.1 Proに匹敵する性能を示し、 SWE-Bench Proで59%、Terminal-Bench 2.1で66%、SWE-fficiencyで34.8%、KernelBench Hardで28.8%を記録しています。初日アクセスを提供してくれたMiniMaxに感謝します。

{% columns %}
{% column width="50%" %}
これでMiniMax M3を直接実行できます [Unsloth Studio](#unsloth-studio-guide)。Unsloth Studio経由で、単一のM3 Ultra 512GB上で5ビット版MiniMax M3をローカル実行した例：

{% hint style="info" %}
MiniMax-M3 GGUFは現在実験的です。MiniMax-M3自体はネイティブなマルチモーダルですが、現在の実験的GGUFは **テキストのみ** で、MiniMax Sparse Attentionはサポートしていません。
{% endhint %}
{% endcolumn %}

{% column width="50%" %}

<figure><img src="/files/c8aec7213611a48bcf79f573abe1d21d03eaccfa" alt="" width="375"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### :gear: 使用ガイド

最小のGGUF量子化は `UD-IQ1_M`は **128GB** のディスク容量を使用します。ファイルサイズにはKVキャッシュやコンテキスト割り当てが含まれていないため、少なくとも **133GBのRAM** を確保してモデルを実行してください。推奨は `UD-IQ3_XXS` は **159GB** です。

この **4ビット** `UD-IQ4_XS` 量子化は **208GB**、一方で `UD-Q4_K_XL` は **265GB**です。これらは256GB以上または512GBクラスのシステム、マルチGPUサーバー、あるいはCPU RAMとGPUオフロードを備えたシステムにより適しています。

**表：推論ハードウェア要件** （単位 = 合計メモリ：RAM + VRAM、または統合メモリ）

<table><thead><tr><th>1ビット</th><th>2ビット</th><th width="128">3ビット</th><th>4ビット</th><th>5-bit</th><th>8ビット</th></tr></thead><tbody><tr><td>133 GB</td><td>148 GB</td><td>164-200 GB</td><td>213-270 GB</td><td>325 GB</td><td>460-470 GB</td></tr></tbody></table>

{% hint style="success" %}
最高の性能を得るには、VRAMとシステムRAMを含む利用可能な総メモリが、量子化済みモデルファイルサイズを十分に上回るようにしてください。
{% endhint %}

#### 推奨設定

MiniMaxは最適なパフォーマンスのために以下のパラメータを推奨しています： `temperature=1.0`, `top_p=0.95`, `top_k=40`.

{% columns %}
{% column %}

| `temperature = 1.0` |
| ------------------- |
| `top_p = 0.95`      |
| `top_k = 40`        |
| {% endcolumn %}     |

{% column %}

* **最大コンテキストウィンドウ：** `1,048,576`
* デフォルトのシステムプロンプト：

{% code overflow="wrap" %}

```
あなたは役に立つアシスタントです。あなたの名前はMiniMax-M3で、MiniMaxによって作られました。
```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

## MiniMax-M3チュートリアルを実行：

このチュートリアルでは、現在の最小の量子化版である `UD-IQ1_M`を使用します。MiniMax-M3は大きいためです。置き換えてください `UD-IQ1_M` で `UD-IQ4_XS`, `UD-Q4_K_XL`、またはマシンに十分なメモリがある場合は別の量子化版を使ってください。これでMiniMax-M3を [Unsloth Studio](#run-in-unsloth-studio).

<a href="/pages/50406078caea6b2622d9cd4936900e0df0722103#unsloth-studio-guide" class="button primary">🦥 Unsloth Studioガイド</a><a href="/pages/50406078caea6b2622d9cd4936900e0df0722103#llama.cpp-guide" class="button primary">🦙 Llama.cppガイド</a>

### 🦥 Unsloth Studioガイド

{% hint style="success" %}
これでMiniMax M3を〜経由で実行できます [Unsloth Studio](#unsloth-studio-guide) ✨。>を使用するようにしてください [`v0.1.463-beta`](https://github.com/unslothai/unsloth/tree/v0.1.462-beta) または `2026.6.6`.
{% endhint %}

MiniMax M3は現在、実行および学習できます [Unsloth Studio](/docs/jp/shii/studio.md)。これはローカルAI向けの新しいオープンソースWeb UIです。Unsloth Studioでは、モデルをローカルで **macOS**, **Windows**、Linux、そして：

{% columns %}
{% column %}

* 検索、ダウンロード、 [GGUFの実行](/docs/jp/shii/studio.md#run-models-locally) およびsafetensorモデル
* [**自己修復** ツール呼び出し](/docs/jp/shii/studio.md#execute-code--heal-tool-calling) + **ウェブ検索**
* [**コード実行**](/docs/jp/shii/studio.md#run-models-locally) （Python、Bash）
* [自動推論](/docs/jp/shii/studio.md#model-arena) パラメータ調整（temp、top-pなど）
* llama.cppによる高速なCPU + GPU推論
* [LLMの学習](/docs/jp/shii/studio.md#no-code-training) VRAMを70%削減しつつ2倍高速
  {% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="/files/c3cb18ff1e86ab57357a3712b0511e41752c66b4" alt=""><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

{% stepper %}
{% step %}

#### Unsloth をインストール

最新のものを使用するようにしてください [`v0.1.463-beta`](https://github.com/unslothai/unsloth/tree/v0.1.462-beta) または `2026.6.6`。ターミナルで実行してください：

**MacOS、Linux、WSL：**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

**Windows PowerShell：**

```bash
irm https://unsloth.ai/install.ps1 | iex
```

{% endstep %}

{% step %}

#### Unsloth を起動

**MacOS、Linux、WSL、Windows:**

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

その後 `http://127.0.0.1:8888` （または指定した URL）をブラウザで開いてください。
{% endstep %}

{% step %}

#### MiniMax M3を検索してダウンロード

初回起動時には、アカウントを保護するためのパスワードを作成し、再度サインインする必要があります。

その後、 [Unsloth Chat](/docs/jp/shii/studio/chat.md) タブを開き、検索バーでMiniMax M3を検索して、目的のモデルと量子化版をダウンロードしてください。

<figure><img src="/files/9c394d0333e737663cd4d15cd8593bc2f62e98e8" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### MiniMax M3を実行

Unsloth Studioを使用すると推論パラメータは自動設定されますが、手動で変更することもできます。コンテキスト長、チャットテンプレート、その他の設定も編集できます。

詳細については、 [Unsloth Studio 推論ガイド](/docs/jp/shii/studio/chat.md).

<div data-with-frame="true"><figure><img src="/files/c8aec7213611a48bcf79f573abe1d21d03eaccfa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 🦙 Llama.cppガイド

{% stepper %}
{% step %}
特定の `llama.cpp` のPRを取得 [**GitHub はこちら**](https://github.com/ggml-org/llama.cpp/pull/24523)。以下のビルド手順に従うこともできます。 `-DGGML_CUDA=ON` を `-DGGML_CUDA=OFF` に変更してください。GPU がない場合や CPU 推論だけを使いたい場合です。 **Apple Mac / Metal デバイスの場合**、 `-DGGML_CUDA=OFF` に設定し、そのまま続行してください。Metal サポートはデフォルトで有効です。

```bash
git clone https://github.com/ggml-org/llama.cpp
cd llama.cpp
git fetch origin pull/24523/head:minimax-m3
git checkout minimax-m3
cmake -B build -DGGML_CUDA=ON
cmake --build build --config Release -j --target llama-cli llama-server
```

{% endstep %}

{% step %}
これで以下を使用できます `llama.cpp` を直接使ってモデルを読み込み・ダウンロードできます。ちょうど `ollama run`のように。まず、希望する量子化タイプを `Q2_K_XL`。また、以下を使用して `export LLAMA_CACHE="folder"` を使って `llama.cpp` 特定の場所に固定できます。なお、このダウンロード प्रक्रियाは非常に遅い場合があるため、次のセクションの手動ダウンロード手順を使うのがおそらく最適です。

```bash
export LLAMA_CACHE="unsloth/MiniMax-M3-GGUF"
./build/bin/llama-cli \
    -hf unsloth/MiniMax-M3-GGUF:UD-IQ1_M \
    --temp 1.0 \\
    --top-p 0.95 \\
    --top-k 40
```

{% hint style="info" %}
注：MiniMax Sparse Attentionはまだサポートされていないため、推論はdense attentionにフォールバックします。
{% endhint %}
{% endstep %}

{% step %}
モデルを手動でダウンロードしたい場合は、以下のコードでダウンロードできます（ `pip install huggingface_hub`をインストールした後）。ダウンロードが止まる場合は、以下を参照： [Hugging Face Hub、XETのデバッグ](/docs/jp/ji-ben/troubleshooting-and-faqs/hugging-face-hub-xet-debugging.md)

```bash
hf download unsloth/MiniMax-M3-GGUF \
    --local-dir unsloth/MiniMax-M3-GGUF \
    --include "*UD-IQ1_M*" # 4ビットの場合は"*UD-IQ4_XS*"を使用
```

{% endstep %}

{% step %}
以下を編集できます `--threads 32` CPUスレッド数として、 `--ctx-size 32768` コンテキスト長として、 `--n-gpu-layers 2` GPUオフロードする層数を指定します。GPUのメモリ不足になる場合は調整してみてください。CPUのみで推論する場合はこれも削除してください。MSAはまだサポートされていないので、 `--ctx-size` 控えめにしてください。非常に長いコンテキストではdense attentionが多くのメモリを使用します。

{% code overflow="wrap" %}

```bash
./build/bin/llama-cli \
    --model unsloth/MiniMax-M3-GGUF/UD-IQ1_M/MiniMax-M3-UD-IQ1_M-00001-of-00004.gguf \
    --temp 1.0 \\
    --top-p 0.95 \\
    --top-k 40
```

{% endcode %}
{% endstep %}
{% endstepper %}

## 📊 ベンチマーク

<figure><img src="/files/663b146e51185fdf0d5cb6502282080a9e6844b5" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/c02f6e55a91c687438df1e7621d309013e74d63d" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://unsloth.ai/docs/jp/moderu/minimax-m3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
