> 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/tutorials/minimax-m3.md).

# MiniMax M3

MiniMax M3 LLMを自分のデバイスでローカル実行しましょう！

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

{% column width="50%" %}

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F7A3LPw7ex1psFIPkY6FF%2Fminimax%20m3%20guide.gif?alt=media&amp;token=b733672e-fa14-4572-952c-c9b3dbf82beb" 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-bit</th><th>2ビット</th><th width="128">3ビット</th><th>4ビット</th><th>5ビット</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 チュートリアルを実行する:

このチュートリアルでは、MiniMax-M3 は大きいため、現在の最小量子化である UD-IQ1\_M を使用します。マシンに十分なメモリがある場合は、UD-IQ1\_M を UD-IQ4\_XS、UD-Q4\_K\_XL、または別の量子化に置き換えてください。これで Unsloth で MiniMax-M3 を実行できます。

Unsloth ガイド

#### Unslothをダウンロード

#### Unslothをダウンロード

<https://unsloth.ai/download>

<https://unsloth.ai/download>

### Unsloth ガイド

#### Unslothをダウンロード

<https://unsloth.ai/download>

{% hint style="success" %}
これで MiniMax M3 を [Unsloth](#unsloth-studio-guide) ✨。> を使用してください [`v0.1.463-beta`](https://github.com/unslothai/unsloth/tree/v0.1.462-beta) に渡すことで有効にできます。 `2026.6.6`.
{% endhint %}

MiniMax M3 は MacOS、Windows、Linux 上の Unsloth で動作します。次のことができます:

{% columns %}
{% column %}

* 検索、ダウンロード、 [GGUFを実行](/docs/jp/shii/studio.md#run-models-locally) および safetensor モデル
* [**自己修復** ツール呼び出し](/docs/jp/shii/studio.md#execute-code--heal-tool-calling) + **web検索**
* [**コード実行**](/docs/jp/shii/studio.md#run-models-locally) （Python、Bash）
* [自動推論](https://unsloth.ai/docs/desktop#feature-deep-dive) パラメータ調整（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="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fszoidwwj70dLm5vBjpmL%2Fdiffusiongemma.gif?alt=media&amp;token=8ce359fd-f92c-4cf8-a491-06b04c505cb7" 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:**
{% endstep %}

{% step %}

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

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

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FYUbbg1xVmfmJYVEQTNaS%2FScreenshot%202026-06-12%20at%206.33.22%E2%80%AFPM.png?alt=media&amp;token=9b672870-3c8b-4b38-bfe8-16cdef0b5e25" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### MiniMax M3 を実行

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F7A3LPw7ex1psFIPkY6FF%2Fminimax%20m3%20guide.gif?alt=media&amp;token=b733672e-fa14-4572-952c-c9b3dbf82beb" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 🦙 Llama.cpp ガイド

{% stepper %}
{% step %}
SPECIFIC PR を取得する `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-chu/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="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F4SjJ6hXo8PijYgtdfMGp%2Fminimaxm3%20short%20benchmarks.jpeg?alt=media&amp;token=1a544bfd-1c81-4b45-89f7-04b88190d473" alt=""><figcaption></figcaption></figure>

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FnRfDibKjJo3LG99RxlqW%2Fminimaxm3.jpeg?alt=media&amp;token=f0c4b21f-9680-4fa8-862f-c79f1c0bf55f" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
