# GGUF dynamiques d'Unsloth sur Aider Polyglot

Nous sommes ravis de montrer comment Unsloth Dynamic GGUFs permet de quantifier des LLM comme [DeepSeek-V3.1](/docs/fr/modeles/tutorials/deepseek-v3.1-how-to-run-locally.md) (671B) jusqu’à seulement **1-bit** ou **3 bits**, tout en restant capable de surpasser des modèles SOTA comme **GPT-4.5, GPT-4.1** (avril 2025) et **Claude-4-Opus** (mai 2025).

Auparavant, [nous avons démontré](/docs/fr/bases/unsloth-dynamic-2.0-ggufs.md) comment Unsloth Dynamic GGUFs surpasse d’autres méthodes de quantification sur 5-shot MMLU et la divergence KL. Maintenant, nous montrons leurs performances sur des évaluations tierces indépendantes en utilisant le **Aider Polyglot** **benchmark.**

<div><figure><img src="/files/a44459c063e628a7b3329db8bacc5515eff252fd" alt="" width="563"><figcaption><p>Benchmarks Aider avec réflexion</p></figcaption></figure> <figure><img src="/files/dff82e69eae54fe7e1dfc70f3a364059c61243cb" alt="" width="563"><figcaption><p>Benchmarks Aider sans réflexion</p></figcaption></figure></div>

### ⭐**Résultats clés**

* Notre **1-bit** Unsloth Dynamic GGUF réduit DeepSeek-V3.1 de **671GB → 192GB (-75 % de taille)** et le mode sans réflexion surpasse largement GPT-4.1 (avr. 2025), GPT-4.5 et DeepSeek-V3-0324.
* **3 bits** Unsloth DeepSeek-V3.1 (réflexion) GGUF : surpasse Claude-4-Opus-20250514 (réflexion).
* **5 bits** Unsloth DeepSeek-V3.1 (sans réflexion) GGUF : égalise les performances de Claude-4-Opus-20250514 (sans réflexion).
* Unsloth Dynamic GGUFs offre systématiquement de meilleures performances que les autres GGUFs imatrix dynamiques non-Unisloth
* Les autres quantifications DeepSeek-V3.1 non-Unisloth en 1 bit et 2 bits, ainsi que la quantification standard en 1 bit sans quantification sélective des couches, n’ont soit pas pu être chargées, soit ont produit du charabia et des sorties en boucle. Cela montre que les Unsloth Dynamic GGUFs parviennent à conserver largement la précision, alors que d’autres méthodes ne fonctionnent même pas.

**Pourquoi le** [**Aider Polyglot**](https://aider.chat/docs/leaderboards/) **benchmark ?** Aider est l’une des mesures les plus complètes de la capacité des LLM à écrire, coder, suivre des instructions et appliquer des modifications sans intervention humaine, ce qui en fait l’un des benchmarks les plus difficiles et les plus utiles pour un usage réel.

{% hint style="success" %}
Le **avantage clé** de l’utilisation du package et des modèles Unsloth est notre rôle actif dans ***la correction de bugs critiques*** dans de grands modèles. Nous avons collaboré directement avec les équipes derrière [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) et [Microsoft (Phi-3/4)](https://simonwillison.net/2025/Jan/11/phi-4-bug-fixes), en contribuant à des correctifs essentiels qui améliorent considérablement la précision.
{% endhint %}

## 🦥Quantification dynamique Unsloth

{% hint style="success" %}
**Le 1 bit dynamique met les couches importantes en 8 ou 16 bits et les couches peu importantes en 1,2,3,4,5 ou 6 bits.**
{% endhint %}

En nov. 2024, nos [Quants dynamiques 4 bits](https://unsloth.ai/blog/dynamic-4bit) ont montré comment on pouvait en grande partie restaurer le fine-tuning QLoRA et la précision du modèle simplement en <mark style="background-color:green;">**quantifiant sélectivement les couches**</mark>. Nous avons ensuite étudié [DeepSeek-R1](/docs/fr/modeles/tutorials/deepseek-r1-how-to-run-locally.md)l’architecture et appliqué cette méthodologie similaire, où nous avons quantifié certaines couches jusqu’à 1 bit et les couches importantes à des bits plus élevés (6, 8 bits). Cette approche a rapidement gagné en popularité et s’est révélée particulièrement efficace pour les modèles MoE, faisant de la quantification dynamique la norme de facto pour la quantification MoE.

Nos Dynamic GGUFs sont encore plus efficaces lorsqu’ils sont associés à notre [jeu de données de calibration imatrix](https://unsloth.ai/docs/fr/bases/unsloth-dynamic-2.0-ggufs/pages/8e3d570b34072053937ce45a7a2125f403689ec3#whats-new-in-dynamic-v2.0), conçu pour les performances en chat et en codage. Tout cela a permis une compression extrême des LLM sans perte catastrophique de qualité.

Par exemple, dans Qwen2-VL-2B-Instruct, quantifier naïvement toutes les couches en 4 bits fait que le modèle ne comprend pas l’image ci-dessous. C’est un train, pas une scène côtière !

{% columns %}
{% column %}

<figure><img src="/files/cba45bdfe8969647b9149fbaaef3401f1bb52b21" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

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

Nous avons également montré des benchmarks dynamiques dans <https://docs.unsloth.ai/basics/unsloth-dynamic-2.0-ggufs> pour Gemma 3 et Llama 4 Scout, montrant à quel point notre méthodologie est efficace :

{% columns %}
{% column %}

<figure><img src="/files/7ed21e57a0168451d5ae4b8f61618e14aae81709" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/6845950f3192aea93c5d03e7c679733150960208" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### ⚙️Configuration du benchmark

Pour nos expériences DeepSeek-V3.1, nous avons comparé différents bits de **Unsloth Dynamic GGUFs** avec :

* **LLM en précision complète, non quantifiés** y compris GPT 4.5, 4.1, Claude-4-Opus, DeepSeek-V3-0324, etc.
* ***Autres*****&#x20;GGUFs imatrix V3.1 dynamiques**
* ***Semi-*****dynamiques** GGUFs imatrix V3.1 (avec certaine quantification sélective des couches) pour **des fins d’ablation**.

Les expériences de benchmark ont principalement été menées par [David Sluys](https://www.linkedin.com/in/david-sluys-231348208/) (neolithic5452 sur [le Discord d’Aider](https://discord.com/channels/1131200896827654144/1408293692074360914)), un contributeur communautaire de confiance pour les évaluations Aider Polyglot. Les tests ont été exécutés \~3 fois puis moyennés pour obtenir un score médian, et la précision Pass-2 est rapportée comme le veut la convention. Il existe quelques extraits de code de benchmark reproductibles dans le Discord d’Aider.

<details>

<summary>Développer pour les benchmarks Aider des modèles de raisonnement</summary>

| Modèle                             | Précision |
| ---------------------------------- | --------- |
| GPT-5                              | 86.7      |
| Gemini 2.5 Pro (juin)              | 83.1      |
| o3                                 | 76.9      |
| DeepSeek V3.1                      | 76.1      |
| **DeepSeek V3.1 Unsloth (3 bits)** | **75.6**  |
| Claude-4-Opus (mai)                | 72        |
| o4-mini (élevé)                    | 72        |
| DeepSeek R1 0528                   | 71.4      |
| **DeepSeek V3.1 Unsloth (2 bits)** | **66.7**  |
| Claude-3.7-Sonnet (févr.)          | 64.9      |
| **DeepSeek V3.1 Unsloth (1 bit)**  | **57.8**  |
| DeepSeek R1                        | 56.9      |

</details>

<details>

<summary>Développer pour les benchmarks Aider des modèles sans raisonnement</summary>

| Modèle                             | Précision |
| ---------------------------------- | --------- |
| DeepSeek V3.1                      | 71.6      |
| Claude-4-Opus (mai)                | 70.7      |
| **DeepSeek V3.1 Unsloth (5 bits)** | **70.7**  |
| **DeepSeek V3.1 Unsloth (4 bits)** | **69.7**  |
| **DeepSeek V3.1 Unsloth (3 bits)** | **68.4**  |
| **DeepSeek V3.1 Unsloth (2 bits)** | **65.8**  |
| Qwen3 235B A22B                    | 59.6      |
| Kimi K2                            | 59.1      |
| **DeepSeek V3.1 Unsloth (1 bit)**  | **55.7**  |
| DeepSeek V3-0324                   | 55.1      |
| GPT-4.1 (avril 2025)               | 52.4      |
| ChatGPT 4o (mars 2025)             | 45.3      |
| GPT-4.5                            | 44.9      |

</details>

DeepSeek V3.1 possède à la fois un mode de raisonnement et un mode sans raisonnement, et nous testons les deux. Pour le mode sans raisonnement, nous observons ci-dessous une tendance claire des performances de nos quantifications dynamiques. Le 5 bits dynamique atteint 70,7 % sur Aider Pass-2, tandis que le 1 bit dynamique atteint 55,7 %. En termes de taille et de précision, les versions 3 et 4 bits sont extrêmement puissantes !

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

## :sparkler:Comparaison avec d’autres quants

Nous exécutons également le benchmark Aider Polyglot sur d’autres GGUFs imatrix dynamiques issus de la communauté et les comparons aux nôtres. Pour garantir une **comparaison équitable**, nous faisons ce qui suit :

1. Nous sélectionnons des fichiers et des types de bits de taille similaire pour chaque quantification Unsloth.
2. Nous utilisons notre **modèle de chat corrigé** si la quantification communautaire ne parvient pas à exécuter le benchmark. Nous avons trouvé certaines quantifications communautaires `{"code":500,"message":"split method must have between 1 and 1 positional arguments and between 0 and 0 keyword arguments at row 3, column 1908"}`, et cela est corrigé en utilisant notre modèle de chat corrigé.

Nous constatons que les quants dynamiques Unsloth fonctionnent remarquablement bien par rapport à d’autres quantifications communautaires pour la même taille de modèle et le même type de quantification !

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

<details>

<summary>Développer pour la comparaison des données numériques brutes avec d’autres quants</summary>

<table><thead><tr><th width="109.25">Quant</th><th width="171.25006103515625">Taille du quant (GB)</th><th>Précision Unsloth %</th><th>Précision de comparaison %</th></tr></thead><tbody><tr><td>IQ2_XXS</td><td>164</td><td></td><td>43.6</td></tr><tr><td>TQ1_0</td><td>170</td><td>50.7</td><td></td></tr><tr><td>IQ1_M</td><td>206</td><td>55.7</td><td></td></tr><tr><td>IQ2_M</td><td>215</td><td></td><td>56.6</td></tr><tr><td>IQ2_XXS</td><td>225</td><td>61.2</td><td></td></tr><tr><td>IQ2_M</td><td>235</td><td>64.3</td><td></td></tr><tr><td>Q2_K_L</td><td>239</td><td></td><td>64.0</td></tr><tr><td>Q2_K_XL</td><td>255</td><td>65.8</td><td></td></tr><tr><td>IQ3_XXS</td><td>268</td><td>65.6</td><td>65.6</td></tr><tr><td>IQ3_XXS</td><td>279</td><td>66.8</td><td></td></tr><tr><td>Q3_K_S</td><td>293</td><td></td><td>65.2</td></tr><tr><td>Q3_K_XL</td><td>300</td><td>68.4</td><td></td></tr><tr><td>IQ4_XS</td><td>357</td><td>69.2</td><td></td></tr><tr><td>IQ4_XS</td><td>360</td><td></td><td>66.3</td></tr><tr><td>Q4_K_XL</td><td>387</td><td>69.7</td><td></td></tr><tr><td>Q4_K_M</td><td>405</td><td>69.7</td><td></td></tr><tr><td>Q4_K_M</td><td>409</td><td></td><td>67.7</td></tr><tr><td>Q5_K_M</td><td>478</td><td></td><td>68.9</td></tr><tr><td>Q5_K_XL</td><td>484</td><td>70.7</td><td></td></tr></tbody></table>

</details>

### :cake:Ablations de la quantification dynamique

Nous avons également effectué quelques ablations pour confirmer si notre jeu de données de calibration et notre méthodologie de quantification dynamique fonctionnent réellement. L’astuce de la méthode dynamique d’Unsloth consiste à quantifier **les couches importantes à des bits plus élevés** par exemple 8 bits, tandis que **les couches peu importantes sont laissées à des bits plus faibles comme 2 bits**.

Pour tester notre méthode, nous laissons des tenseurs spécifiques en précision plus faible, comme 4 bits, versus précision plus élevée. Par exemple ci-dessous, nous laissons `attn_k_b` les tenseurs en 4 bits (semi-dynamique) vs 8 bits (Unsloth actuel), et en augmentant la taille du quant de seulement \~100 Mo environ (<0,1 %), la précision grimpe de façon spectaculaire !

{% hint style="success" %}
`attn_k_b` et d’autres tenseurs dans DeepSeek V3.1 sont très importants / sensibles à la quantification et devraient être laissés en précision plus élevée pour conserver la précision !
{% endhint %}

<figure><img src="/files/9b668e5e232ac085191fc3af32a0138ce031cb90" alt=""><figcaption></figcaption></figure>

### :bug:Correctifs du bug du modèle de chat

Lors des tests des quantifications DeepSeek-V3.1, nous avons trouvé certaines quantifications à plus faible nombre de bits ne fermant pas `<think> </think>` correctement ou produisant un formatage étrange. Cela a conduit certaines quantifications communautaires à ne pas fonctionner à plus faible nombre de bits, ce qui a entraîné des comparaisons injustes. Nous avons découvert que l’utilisation de minja par llama.cpp (une version plus simple de jinja) n’accepte pas d’argument positionnel dans `.split`. Nous avons dû changer :

```
{%- set content = content.split("</think>", 1)[1] -%}
```

vers la version ci-dessous :

```
{%- set splitted = content.split("</think>") -%}
{%- set content = splitted[1:] | join("</think>") -%}
```

Voir [ici](https://huggingface.co/unsloth/DeepSeek-V3.1-GGUF?chat_template=default\&format=true) pour notre modèle de chat corrigé ou [ici](https://huggingface.co/unsloth/DeepSeek-V3.1/raw/main/chat_template.jinja) pour un fichier jinja brut.

### :bar\_chart:Taux de réussite 1

Aider est principalement rapporté sur le taux de réussite 2. Nous rapportons également le taux de réussite 1 pour comparer les quantifications communautaires de même taille. Nous constatons que nos quantifications dynamiques font bien mieux que les autres quantifications communautaires de tailles similaires, en particulier en dessous de 2 bits et au-dessus de 4 bits. Les versions 3 et 4 bits ont des performances tout aussi bonnes.

<figure><img src="/files/9158fb1d41c3d10d91d16d9b16582776b71ff468" alt=""><figcaption></figcaption></figure>

## :computer:Exécuter les quants dynamiques DeepSeek V3.1

Rendez-vous sur notre [guide DeepSeek V3.1](/docs/fr/modeles/tutorials/deepseek-r1-how-to-run-locally/deepseek-r1-dynamic-1.58-bit.md) ou, pour obtenir rapidement la version dynamique 2 bits, faites :

```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-quantize llama-cli llama-gguf-split llama-mtmd-cli llama-server
cp llama.cpp/build/bin/llama-* llama.cpp
```

puis utilisez `llama.cpp` pour télécharger directement les poids. Nous avons déjà défini les paramètres suggérés optimaux comme la température, le modèle de chat, etc. :

```bash
export LLAMA_CACHE="unsloth/DeepSeek-V3.1-GGUF"
./llama.cpp/llama-cli \
    -hf unsloth/DeepSeek-V3.1-GGUF:Q2_K_XL \
    --jinja \
    --n-gpu-layers 99 \
    --temp 0.6 \
    --top-p 0.95 \
    --min-p 0.01 \
    --ctx-size 8192 \
    --seed 3407 \
    -ot ".ffn_.*_exps.=CPU"
```


---

# Agent Instructions: 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:

```
GET https://unsloth.ai/docs/fr/bases/unsloth-dynamic-2.0-ggufs/unsloth-dynamic-ggufs-on-aider-polyglot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
