> 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-bit 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%を記録しています。Day zeroアクセスを提供してくれた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="/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ビット</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) + **ウェブ検索**
* [**コード実行**](/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="/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：**
{% 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を実行

<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はまだサポートされていないため、推論は密な注意にフォールバックします。
{% 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-bit には "*UD-IQ4_XS*" を使用
```

{% endstep %}

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

{% 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.
