> 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/ji-ben/dynamic-3.0-ggufs.md).

# Unsloth Dynamic 3.0 GGUF

[**Unsloth**](https://github.com/unslothai/unsloth) **Dynamic v3.0** は、私たちのDynamic量子化の次のイテレーションであり、Dynamic v2.0に比べて大きな改善です。

本日、私たちは [**Qwen3.8-27B**](/docs/jp/moderu/qwen3.8.md) のDynamic v3.0量子化をリリースします。これは **同じサイズでトップ1%精度が10%以上向上** し、 **他のすべての提供元**と比べて。これは、私たちが最初に共有した **早期プレビュー** 版のDynamic v3.0の更新です。新しい3.0 GGUFは、 **llama.cpp** や [**Unsloth Desktop**](/docs/jp/desktop.md).

{% columns %}
{% column width="41.66666666666667%" %}
などほとんどの推論エンジンで動作し、同じサイズを保ちながら、Dynamic v3.0全体としてより多くのモデル品質を保持し、 **Divergence-300** @32 と **KL Divergence**.

また、皆さまのご支援に心から感謝します！わずか5日でUnsloth Qwen3.8のダウンロードが510万件を超えました！
{% endcolumn %}

{% column width="58.33333333333333%" %}

<figure><img src="/files/b3428dc51a465264600ee5fdfe7058b7d8d609ec" alt=""><figcaption><p>下に、より多くのグラフ/ベンチマークと分析を示します</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

私たちの新しい手法は、多くの新機能と改善を組み合わせています。現在は、多様なソースからより高品質なimatrixキャリブレーションデータセットを使用しています。データセットは **エージェント的コーディング、チャット**、および多言語性能向けに調整されています。さらに **レイヤー選択** も改善し、可能な限りモデル品質を保持するため、さらに多くの量子化技術を導入しました。

私たちは **imatrixキャリブレーションデータセットで学習しません**し、 **QAT** や **QAD**も使いません。すべては **事後学習量子化**によって行われます。使用したimatrixファイルは、コミュニティがテスト、評価、利用できるよう公開しています。研究者や開発者の皆さまには、私たちのUnsloth quants/imatrixを使ってQwen3.8の派生版やファインチューニング版を作成することを推奨します。私たちの [過学習分析](#not-overfitting) もご覧ください。

* また、私たちは `UD-Q2_K_XL` 以下の小さなquantsからMTPモジュールを削除し、約500MBのディスク容量を節約しました（必要なら `Q4_0` のMTP別モジュールを使えます）
* また、より小さなUD-1bit quantもいくつか作成しました。 `UD-IQ1_S` は6.2GB（MTPなし）で、トップ1%精度の約72%を維持しつつ、サイズは89%小さくなっています。
* `UD-Q2_K_XL` は、次点よりトップ1%で約8%高い精度を示し、9.83GBで、1つの小さなJSバグを含む動作するHTMLプログラムを作成できました。以前は壊れていました。

<figure><img src="/files/3ccb55ed274ad891dfd5085b6d22c0457b91a101" alt="" width="360"><figcaption><p>2ビットのQwen3.8-27B GGUFで生成</p></figcaption></figure>

### 🔀 Divergence-300 @32

一般的には、Kimi-K3の「Dynamic 1-bit reaches **\~78.9%** トップ1精度を達成しつつ **62%小さい**」のようにトップ1%精度を報告しています。ただしトップ1%は1回の予測に対するargmaxなので、実際の推論を評価するのにはあまり効果的ではありません。

Terminal-Bench 2.1 + DeepSWE + Harbor + MathArena 2025-26 + 非ラテン語/長文ドキュメントのプロンプトから300件の保留例（キャリブレーションデータセットには含まれない）を用意し、BF16とすべてのquantsおよび提供元に対して32トークンのgreedy argmaxデコーディングを行いました。 [過学習分析](#not-overfitting) で過学習の詳細をご覧ください。

これにより、過学習があるかどうか、また量子化出力が複数トークンにわたってBF16の軌跡と似ているかどうかを評価できます。これは、KLD top-1%を32トークン時のKLD top-1%のように拡張するため、top-1%精度よりも優れた指標です。

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

### :question:1ビットはエージェント用途には使用すべきではありません

で見られるように [#divergence-300-32](#divergence-300-32 "mention")、32トークン予測ではUD-Q2\_K\_XLからUD-IQ2\_Sへの急激な低下があり、精度は約25%から8〜10%未満まで落ちます。この急激な低下は、ツール呼び出しや非思考モードが崩壊することを意味します。1ビットを使う場合のいくつかの問題と対策:

1. **過剰なループ**\
   UD-Q2\_K\_XL未満のquantsを使うと、多くのループが見られます。 `presence_penalty = 1.5` をすべての場合で（またはそれ以上）使用してください
2. **空の応答**\
   1ビットquantでは、少なくとも低い推論設定で常にthinkingを有効にしてください。非推論モードでは、そもそもモデルが出力しなくなります。
3. **エージェント用途とツール呼び出し**\
   ツール呼び出しにはモデルを使わないでください。 **重い量子化でも保持されるのは** 一般知識だけで、モデルはツール呼び出しに失敗するか、ツールを呼び続けるか、あるいはまったく呼び出しません。
4. **一般知識は機能します**\
   77%のTop-1%回復率は、実際の推論ワークロードにおけるより良い指標である8%のDivergence-300 @32の代わりにはなりません。非常に短い一般知識の事実質問には使えますが、UD-Q2\_K\_XLを使うのが最善です。

### 🔀 KL Divergenceベンチマーク

私たちは全提供元に対してKLDベンチマークも実施し、Top-1%とKLD平均を報告しています。すべてのレベル、特に小さいquantサイズでは、Unsloth UD-3 quantsは同じディスク容量で最大+10%の追加トップ1%精度を達成します！

すべてのプロットでは、公平な比較のため、ディスク容量を計算する際にx軸からMTPヘッドを除外しています。

<figure><img src="/files/980a42597a4b9d8d328239ea8c1a8ea1ce6d5c9e" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/18e88762431a783c08c855513006f9b42388f657" alt=""><figcaption></figcaption></figure>

### :dove:過学習していない

未見のWikitextとCodeで以前のUD-2と比較すると、KLDが大幅に改善されています。大きいものではそれほどではないため、より大きなquantsにはまだ古いUD-2を使っています。今後はそれらも実験して改善する予定です。

また、キャリブレーションには完全に異なるデータセットを使い、漏れを可能な限り取り除くことで過学習を制御しています。これらの未見データセットでKLDをテストし、さらにQAD / QATは行わず純粋なPTQのみなので、他のQAD / QATアプローチに比べて過学習の懸念は小さいです。

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

同様に [#divergence-300-32](#divergence-300-32 "mention") DeepSWE、Terminal Benchなどからの300プロンプトの未見データセットを使用し、過学習を評価する別のデータセットとして機能します。そして、新しいUD-3手法が過学習していないことを示しています。

***

## Dynamic v2.0（旧）

私たちは [Unsloth](https://github.com/unslothai/unsloth) Dynamic v2.0量子化を導入します。これは以前のquantsに対する大幅なアップグレードです。この新しい手法は主要な量子化手法を上回り、 [Aider Polyglot](/docs/jp/ji-ben/dynamic-3.0-ggufs/unsloth-dynamic-ggufs-on-aider-polyglot.md)、5-shot MMLU、KL Divergenceで新たなベンチマークを打ち立てます。

これにより、精度をできるだけ保ちながら、 [量子化LLM](/docs/jp/moderu/tutorials.md) の実行とファインチューニングが可能になります！2.0 GGUFは、llama.cppのようなほとんどの推論エンジンで実行できます。 [Unsloth Studio](/docs/jp/xin-zhe/studio.md) など

{% columns %}
{% column %}
**2026年4月20日更新：** の新しいGGUFベンチマークをご覧ください [Qwen3.6](/docs/jp/moderu/qwen3.6.md#unsloth-gguf-benchmarks) や [Gemma 4](/docs/jp/moderu/gemma-4.md#unsloth-gguf-benchmarks).

[2026年2月27日更新：](/docs/jp/moderu/qwen3.5/gguf-benchmarks.md) **Qwen3.5** が公開され、いくつかのツール呼び出しチャットテンプレートの問題を修正し、すべてのGGUFをperplexityとKL Divergenceでベンチマークしました。 [ベンチマークをご覧ください！](/docs/jp/moderu/qwen3.5/gguf-benchmarks.md)

の **大きな利点** は [Unslothパッケージ](https://github.com/unslothai/unsloth) とquantsを使うことの鍵となる利点は、主要モデルのバグ修正に積極的に関わっていることです。私たちは [Qwen3](https://www.reddit.com/r/LocalLLaMA/comments/1kaodxu/qwen3_unsloth_dynamic_ggufs_128k_context_bug_fixes/), [Meta（Llama 4）](https://github.com/ggml-org/llama.cpp/pull/12889), [Mistral（Devstral）](https://app.gitbook.com/o/HpyELzcNe0topgVLGCZY/s/xhOjnexMCB3dmuQFQ2Zq/~/changes/618/basics/tutorials-how-to-fine-tune-and-run-llms/devstral-how-to-run-and-fine-tune), [Google（Gemma 1–3）](https://news.ycombinator.com/item?id=39671146) や [Microsoft（Phi-3/4）](https://simonwillison.net/2025/Jan/11/phi-4-bug-fixes)のチームと直接協力し、精度を高める修正に貢献してきました。
{% endcolumn %}

{% column %}

<figure><img src="/files/d265501d0f0774cfc0fc76a1d11f9ff5179a6a94" alt=""><figcaption><p>Gemma 4 26B A4Bベンチマーク（低いほど良い）</p></figcaption></figure>

<figure><img src="/files/4c08db77b028c47fb00e50cef262107be104ee6c" alt=""><figcaption><p>Qwen3.6ベンチマーク（低いほど良い）</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="success" %}
Unsloth Dynamic GGUFは現在 [Unsloth Studio](/docs/jp/xin-zhe/studio.md) ✨

<img src="/files/27973fefe5b7ff34e02e2db67d51a11ac926e6a1" alt="" data-size="original">
{% endhint %}

{% hint style="success" %}
[2025年9月10日更新：](/docs/jp/ji-ben/dynamic-3.0-ggufs/unsloth-dynamic-ggufs-on-aider-polyglot.md) より厳しいベンチマークをご希望だったので、Aider Polyglotの結果をお見せします！私たちのDynamic 3-bit DeepSeek V3.1 GGUFスコアは **75.6%**、多くのフル精度SOTA LLMを上回っています。 [続きを読む。](/docs/jp/ji-ben/dynamic-3.0-ggufs/unsloth-dynamic-ggufs-on-aider-polyglot.md)

<img src="/files/4f1c2bb2ed98c6a7bf224080a758a9e314fb9d77" alt="DeepSeek-V3.2 Thinking Aider Benchmarks" data-size="original"><img src="/files/8b5a794d2673d4dcc10f77ec2eddb45ce507c350" alt="Llama 4 5-shot MMLU Benchmarks" data-size="original">
{% endhint %}

\# !pip install huggingface\_hub hf\_transfer

<div><figure><img src="/files/76def291f438cd1ff454aa7c6f1de12650b34040" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="/files/caf01dd085af11bfa9e713556cca7de78754c2ed" alt="" width="450"><figcaption></figcaption></figure></div>

Unsloth以外のquantsよりもUnslothのGGUFの方が約8GB小さいにもかかわらず、より良い性能を示すのがわかります。

ベンチマークと評価の詳細な分析はさらに下にあります。

### 💡 Dynamic v2.0の新機能は？

* **GGUF + safetensors向けにレイヤー選択を刷新：** Unsloth Dynamic 2.0は、より賢く広範囲にレイヤーを選択的に量子化するようになりました。選択された一部のレイヤーだけを変更するのではなく、可能なすべてのレイヤーの量子化タイプを動的に調整し、組み合わせはレイヤーやモデルごとに異なります。
* 現在選択されているものと今後すべてのGGUFアップロードは、Dynamic 2.0と新しいキャリブレーションデータセットを利用します。データセットには1.5M以上の **トークン** （モデルによる）を含み、高品質で手作業でキュレート・クリーニングされたデータで構成されており、会話型チャット性能を大幅に向上させます。
* 以前は、私たちのDynamic量子化（DeepSeek-R1 1.58-bit GGUF）はMoEアーキテクチャに対してのみ有効でした。 <mark style="background-color:green;">**Dynamic 2.0量子化は現在すべてのモデル（MOEと非MOEを含む）で動作します**</mark>.
* **モデル固有のquants：** 各モデルは現在、個別に調整された量子化方式を使用します。例えば、Gemma 3で量子化されるレイヤーはLlama 4のものと大きく異なります。
* 特にApple SiliconやARMデバイスでの効率を最大化するため、現在はQ4\_NL、Q5.1、Q5.0、Q4.1、Q4.0形式も追加しています。

正確なベンチマークを保証するため、Llama 4とGemma 3の公式5-shot MMLUスコアに一致する社内評価フレームワークを構築しました。これにより、フル精度とDynamic v2.0のあいだで、 **QAT** および標準の **imatrix** GGUF quants。

<div><figure><img src="/files/0d31de89da68c90cf8f6e5d60808143107b9cca5" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="/files/6e0e5e55ee912feb847a24d5f3ffbcf629bfc11e" alt="" width="563"><figcaption></figcaption></figure></div>

今後のすべてのGGUFアップロードはUnsloth Dynamic 2.0を利用し、今後はDynamic 4-bit safetensor quantsもこれの恩恵を受けます。

## 📊 なぜKL Divergenceなのか？

[精度だけでは不十分](https://arxiv.org/pdf/2407.09141) は、不要なレイヤーを選ぶだけのプルーニングであっても、「フリップ」の観点では大きな差が生じることを示しています。「フリップ」とは、不正解から正解へ、またはその逆に答えが変わることを指します。論文は、レイヤーをプルーニングしたり量子化したりしてもMMLUが下がらない場合があることを示していますが、それは一部の不正解が「フリップ」して正解になった可能性があるからです。私たちの目標は元のモデルに一致させることなので、「フリップ」を測るのは良い指標です。

<div><figure><img src="/files/d75c118ff93dd0d9778403518a8dad5f8aaa5584" alt=""><figcaption></figcaption></figure> <figure><img src="/files/d07ca6fef4c12c638357e43ddbadb9338a44af55" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**KL Divergence** は **量子化誤差を報告するためのゴールドスタンダードの一つであるべきです** 。これは論文「Accuracy is Not All You Need」によるものです。 **パープレキシティを使うのは誤りです** 出力トークンの値が相殺し合う可能性があるため、KLDや、以下のようなより難しいベンチマークを使う必要があります [Aider](/docs/jp/ji-ben/dynamic-3.0-ggufs/unsloth-dynamic-ggufs-on-aider-polyglot.md).
{% endhint %}

また、興味深いことにKL Divergenceはフリップと非常に強い相関があることも示しており、したがって私たちの目標は、量子化のディスク容量をできるだけ増やさずに平均KL Divergenceを減らすことです。

## ⚖️ キャリブレーションデータセットの過学習

多くのフレームワークは、Wikipedia記事のテストセットを使ってperplexityとKL Divergenceを報告します。しかし、Wikipedia関連でもあるキャリブレーションデータセットを使うと、quantが過学習し、より低いperplexityスコアを得ることに気づきました。私たちは [Calibration\_v3](https://gist.github.com/bartowski1182/eb213dccb3571f863da82e99418f81e8) や [Calibration\_v5](https://gist.github.com/tristandruyen/9e207a95c7d75ddf37525d353e00659c/) データセットを使用して公平なテストを行っており、これには一部のwikitextデータなどが含まれます。 <mark style="background-color:red;">**また、instructモデルには固有のチャットテンプレートがあり、テキストのみのキャリブレーションデータセットはinstructモデルには効果的ではありません**</mark> （baseモデルには有効です）。実際、ほとんどのimatrix GGUFは通常これらの問題を伴ってキャリブレーションされています。その結果、モデルがそのドメイン向けに本質的に最適化されているため、Wikipediaデータも使うKL Divergenceベンチマークでは自然とより良い性能を示します。

公正で管理された評価を確実にするため、KL Divergenceをベンチマークする際には、チャット性能向けに最適化された自前のキャリブレーションデータセットは使用しません。その代わり、同じ標準Wikipediaデータセットを使ってテストを行い、Dynamic 2.0手法の性能をベースラインのimatrix手法と直接比較できるようにしました。

## :1234: MMLU再現の冒険

* MMLU 5-shotの再現は悪夢のようでした。私たちは <mark style="background-color:red;">**再現できませんでした**</mark> Llama 3.1 (8B) Instruct、Gemma 3 (12B)など多くのモデルでMMLU結果を再現できませんでした。これは <mark style="background-color:yellow;">**微妙な実装上の問題**</mark>によるものです。例えばLlama 3.1 (8B)は約68.2%になるはずですが、誤った実装では <mark style="background-color:red;">**35%の精度**</mark>

<figure><img src="/files/17c14e99b304fb73f51e6a2e9b849569fbeea0e2" alt="" width="375"><figcaption><p>MMLUの実装上の問題</p></figcaption></figure>

* Llama 3.1 (8B) Instructは、素朴なMMLU実装ではMMLU 5-shot精度が67.8%です。しかし私たちはLlama **は"A"と"\_A"（前にスペースが付いたA）を別々のトークンIDとしてトークナイズします**。スペースありとなしの両方を考慮すると、68.2%になります <mark style="background-color:green;">(+0.4%)</mark>
* 興味深いことに、Llama 3はEleuther AIの [LLM Harness](https://github.com/EleutherAI/lm-evaluation-harness/blob/main/lm_eval/tasks/llama3/instruct/mmlu/_continuation_template_yaml) も <mark style="background-color:purple;">**「The best answer is」**</mark> を質問に付け加えます。これはLlama 3の元のMMLUベンチマークに従っています。
* 他にも多くの微妙な問題があるため、すべてを管理された環境でベンチマークするために、私たちは [github.com/hendrycks/test](https://github.com/hendrycks/test) を直接調査し、複数モデルで結果を検証し、報告値と比較して独自のMMLU実装をゼロから設計しました。

## :sparkles: Gemma 3 QAT再現、ベンチマーク

GemmaチームはGemma 3の2つのQAT（量子化対応学習）版をリリースしました：

1. Q4\_0 GGUF - 式によりすべてのレイヤーをQ4\_0に量子化 `w = q * block_scale` 、各ブロックは32個の重みを持ちます。詳しくは [llama.cpp wiki ](https://github.com/ggml-org/llama.cpp/wiki/Tensor-Encoding-Schemes)をご覧ください。
2. int4版 - おそらく [TorchAO int4スタイル](https://github.com/pytorch/ao/blob/main/torchao/quantization/README.md)?

私たちはすべてのQ4\_0 GGUF版をベンチマークし、12Bモデルで広範な実験を行いました。 **12B Q4\_0 QATモデルは67.07%** を達成し、一方フルbfloat16の12B版は5-shot MMLUで67.15%です。これは非常に印象的です！27Bモデルはほぼ同等です！

<table><thead><tr><th>指標</th><th>1B</th><th valign="middle">4B</th><th>12B</th><th>27B</th></tr></thead><tbody><tr><td>MMLU 5-shot</td><td>26.12%</td><td valign="middle">55.13%</td><td><mark style="background-color:blue;"><strong>67.07%（67.15% BF16）</strong></mark></td><td><strong>70.64%（71.5% BF16）</strong></td></tr><tr><td>ディスク容量</td><td>0.93GB</td><td valign="middle">2.94GB</td><td><strong>7.52GB</strong></td><td>16.05GB</td></tr><tr><td><mark style="background-color:green;"><strong>効率*</strong></mark></td><td>1.20</td><td valign="middle">10.26</td><td><strong>5.59</strong></td><td>2.84</td></tr></tbody></table>

私たちは新しい **効率指標** を設計しました。これは、モデルの有用性を、ディスクサイズとMMLU 5-shotスコアも考慮して計算します：

$$
\text{Efficiency} = \frac{\text{MMLU 5 shot score} - 25}{\text{Disk Space GB}}
$$

{% hint style="warning" %}
私たちは **25を引く必要があります** 。MMLUにはA、B、C、Dの4つの選択肢があるからです。単にランダムに答えを選ぶモデルを作ると仮定すると、精度は25%で、ディスク容量は数バイトしかありません。しかし明らかにこれは有用なモデルではありません。
{% endhint %}

ベースモデルとのKL Divergenceについて、以下は改善を示す表です。KL Divergenceは0に近いほど良く（つまり0はフル精度モデルと同一を意味します）、

| Quant     | ベースラインKLD | GB    | 新しいKLD   | GB    |
| --------- | --------- | ----- | -------- | ----- |
| IQ1\_S    | 1.035688  | 5.83  | 0.972932 | 6.06  |
| IQ1\_M    | 0.832252  | 6.33  | 0.800049 | 6.51  |
| IQ2\_XXS  | 0.535764  | 7.16  | 0.521039 | 7.31  |
| IQ2\_M    | 0.26554   | 8.84  | 0.258192 | 8.96  |
| Q2\_K\_XL | 0.229671  | 9.78  | 0.220937 | 9.95  |
| Q3\_K\_XL | 0.087845  | 12.51 | 0.080617 | 12.76 |
| Q4\_K\_XL | 0.024916  | 15.41 | 0.023701 | 15.64 |

ディスク容量増加とKL Divergence比の変化の比率をプロットすると、はるかに明確な利点が見えます！私たちの動的2bit Q2\_K\_XLはKLDをかなり削減します（約7.5%）。

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

Gemma 3（27B）のMMLU結果の切り詰めた表です。下をご覧ください。

1. **私たちの動的4bit版は、QAT版より2GB小さいうえ、精度は+1%向上しています！**
2. 効率面では、2bit Q2\_K\_XLなどはとても優秀なようです！

| Quant          | Unsloth   | Unsloth + QAT | ディスクサイズ   | 効率       |
| -------------- | --------- | ------------- | --------- | -------- |
| IQ1\_M         | 48.10     | 47.23         | 6.51      | 3.42     |
| IQ2\_XXS       | 59.20     | 56.57         | 7.31      | 4.32     |
| IQ2\_M         | 66.47     | 64.47         | 8.96      | 4.40     |
| Q2\_K\_XL      | 68.70     | 67.77         | 9.95      | 4.30     |
| Q3\_K\_XL      | 70.87     | 69.50         | 12.76     | 3.49     |
| **Q4\_K\_XL**  | **71.47** | **71.07**     | **15.64** | **2.94** |
| **Google QAT** |           | **70.64**     | **17.2**  | **2.65** |

<details>

<summary><mark style="color:緑;">ここをクリック</mark> でGoogleのGemma 3（27B）QATベンチマークの全体版をご覧ください：</summary>

| モデル            | Unsloth   | Unsloth + QAT | ディスクサイズ   | 効率       |
| -------------- | --------- | ------------- | --------- | -------- |
| IQ1\_S         | 41.87     | 43.37         | 6.06      | 3.03     |
| IQ1\_M         | 48.10     | 47.23         | 6.51      | 3.42     |
| IQ2\_XXS       | 59.20     | 56.57         | 7.31      | 4.32     |
| IQ2\_M         | 66.47     | 64.47         | 8.96      | 4.40     |
| Q2\_K          | 68.50     | 67.60         | 9.78      | 4.35     |
| Q2\_K\_XL      | 68.70     | 67.77         | 9.95      | 4.30     |
| IQ3\_XXS       | 68.27     | 67.07         | 10.07     | 4.18     |
| Q3\_K\_M       | 70.70     | 69.77         | 12.51     | 3.58     |
| Q3\_K\_XL      | 70.87     | 69.50         | 12.76     | 3.49     |
| Q4\_K\_M       | 71.23     | 71.00         | 15.41     | 2.98     |
| **Q4\_K\_XL**  | **71.47** | **71.07**     | **15.64** | **2.94** |
| Q5\_K\_M       | 71.77     | 71.23         | 17.95     | 2.58     |
| Q6\_K          | 71.87     | 71.60         | 20.64     | 2.26     |
| Q8\_0          | 71.60     | 71.53         | 26.74     | 1.74     |
| **Google QAT** |           | **70.64**     | **17.2**  | **2.65** |

</details>

## :llama: Llama 4のバグ修正 + 実行

私たちはLlama 4のいくつかのバグ修正も手伝いました：

* Llama 4 Scoutは公式リポジトリでRoPE Scalingの設定を変更しました。これを有効にするため、llama.cppの問題解決を手伝いました [この変更をここで](https://github.com/ggml-org/llama.cpp/pull/12889)

  <figure><img src="/files/5185380cb6ac699a16bfce0ad610740dd84b7c71" alt=""><figcaption></figcaption></figure>
* Llama 4のScoutとMaverickの両方におけるQK Normのepsilonは設定ファイルから取得されるべきです。つまり1e-06ではなく1e-05を使う必要があります。私たちはこれらの解決を [llama.cpp](https://github.com/ggml-org/llama.cpp/pull/12889) や [transformers](https://github.com/huggingface/transformers/pull/37418)
* で手伝いました。Llama 4チームとvLLMも、QK Normが全ヘッドで共有されている問題（そうあるべきではない）を独自に修正しました [ここ](https://github.com/vllm-project/vllm/pull/16311)。MMLU Proは68.58%から71.53%に向上しました。
* [Wolfram Ravenwolf](https://x.com/WolframRvnwlf/status/1909735579564331016) は、llama.cpp経由の私たちのGGUFがサードパーティの推論プロバイダーよりもはるかに高い精度を達成することを示しました。これはおそらく上で説明した問題の組み合わせであり、また量子化の問題による可能性も高いです。

  <figure><img src="/files/8e0762a6ae64b78a0c3fe445fa5dc8c475bcb836" alt=""><figcaption></figcaption></figure>

グラフに示すように、私たちの4-bit Dynamic QAT量子化は、サイズが小さいにもかかわらず、5-shot MMLUでより良い性能を発揮します。

### Llama 4 Scoutの実行：

たとえばLlama 4 Scoutを実行するには、まずllama.cppをクローンします：

```bash
apt-get update
apt-get install pciutils build-essential cmake curl libcurl4-openssl-dev -y
git clone https://github.com/ggml-org/llama.cpp
cmake llama.cpp -B llama.cpp/build \
    -DBUILD_SHARED_LIBS=OFF -DGGML_CUDA=ON -DLLAMA_CURL=ON
cmake --build llama.cpp/build --config Release -j --clean-first --target llama-cli llama-gguf-split
cp llama.cpp/build/bin/llama-* llama.cpp
```

次に、Scout向けの新しいdynamic v 2.0 quantをダウンロードします：

```python
# !pip install huggingface_hub hf_transfer
import os
os.environ["HF_HUB_ENABLE_HF_TRANSFER"] = "1"
from huggingface_hub import snapshot_download
snapshot_download(
    repo_id = "unsloth/Llama-4-Scout-17B-16E-Instruct-GGUF",
    local_dir = "unsloth/Llama-4-Scout-17B-16E-Instruct-GGUF",
    allow_patterns = ["*IQ2_XXS*"],
)
```

では、推論を行いましょう！

{% code overflow="wrap" %}

```bash
./llama.cpp/llama-cli \
    --model unsloth/Llama-4-Scout-17B-16E-Instruct-GGUF/Llama-4-Scout-17B-16E-Instruct-UD-IQ2_XXS.gguf \
    --threads 32 \
    --ctx-size 16384 \
    --n-gpu-layers 99 \
    -ot ".ffn_.*_exps.=CPU" \
    --seed 3407 \
    --prio 3 \
    --temp 0.6 \
    --min-p 0.01 \
    --top-p 0.9 \
    -no-cnv \
    --prompt "<|header_start|>user<|header_end|>\n\nFlappy Birdゲームを作成してください。<|eot|><|header_start|>assistant<|header_end|>\n\n"
```

{% endcode %}

{% hint style="success" %}
Llama 4の実行について詳しくはこちら： <https://docs.unsloth.ai/basics/tutorial-how-to-run-and-fine-tune-llama-4>
{% endhint %}


---

# 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/ji-ben/dynamic-3.0-ggufs.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.
