> 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 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ビット</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 のチュートリアルを実行する：

このチュートリアルでは、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 search**
* [**コード実行**](/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 %}
特定の `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/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.
