File size: 7,506 Bytes
11ca70c
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
59cafbb
11ca70c
 
 
 
 
0465659
fdfcf14
80d7abb
4e106e4
95f0878
11ca70c
 
 
 
 
 
 
0465659
fdfcf14
2b489af
1d5d168
80d7abb
20e6100
11ca70c
 
4e106e4
3c24ab7
11ca70c
 
 
 
 
95f0878
11ca70c
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
---
base_model: deepseek-ai/DeepSeek-V2.5
inference: false
library_name: gguf
license: other
license_link: https://github.com/deepseek-ai/DeepSeek-V2/blob/main/LICENSE-MODEL
license_name: deepseek
pipeline_tag: text-generation
quantized_by: legraphista
tags:
- quantized
- GGUF
- quantization
- imat
- imatrix
- static
- 16bit
- 8bit
- 6bit
- 5bit
- 4bit
- 3bit
- 2bit
- 1bit
---

# DeepSeek-V2.5-IMat-GGUF
_Llama.cpp imatrix quantization of deepseek-ai/DeepSeek-V2.5_

Original Model: [deepseek-ai/DeepSeek-V2.5](https://huggingface.co/deepseek-ai/DeepSeek-V2.5)    
Original dtype: `BF16` (`bfloat16`)  
Quantized by:  llama.cpp [b3675](https://github.com/ggerganov/llama.cpp/releases/tag/b3675)  
IMatrix dataset: [here](https://gist.githubusercontent.com/bartowski1182/eb213dccb3571f863da82e99418f81e8/raw/b2869d80f5c16fd7082594248e80144677736635/calibration_datav3.txt)  

- [Files](#files)
    - [IMatrix](#imatrix)
    - [Common Quants](#common-quants)
    - [All Quants](#all-quants)
- [Downloading using huggingface-cli](#downloading-using-huggingface-cli)
- [Inference](#inference)
    - [Simple chat template](#simple-chat-template)
    - [Chat template with system prompt](#chat-template-with-system-prompt)
    - [Llama.cpp](#llama-cpp)
- [FAQ](#faq)
    - [Why is the IMatrix not applied everywhere?](#why-is-the-imatrix-not-applied-everywhere)
    - [How do I merge a split GGUF?](#how-do-i-merge-a-split-gguf)

---

## Files

### IMatrix
Status: ✅ Available  
Link: [here](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/blob/main/imatrix.dat)

### Common Quants
| Filename | Quant type | File Size | Status | Uses IMatrix | Is Split |
| -------- | ---------- | --------- | ------ | ------------ | -------- |
| [DeepSeek-V2.5.Q8_0/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q8_0) | Q8_0 | 250.62GB | ✅ Available | ⚪ Static | ✂ Yes
| [DeepSeek-V2.5.Q6_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q6_K) | Q6_K | 193.54GB | ✅ Available | ⚪ Static | ✂ Yes
| [DeepSeek-V2.5.Q4_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q4_K) | Q4_K | 142.45GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| [DeepSeek-V2.5.Q3_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q3_K) | Q3_K | 112.67GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| [DeepSeek-V2.5.Q2_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q2_K) | Q2_K | 85.95GB | ✅ Available | 🟢 IMatrix | ✂ Yes


### All Quants
| Filename | Quant type | File Size | Status | Uses IMatrix | Is Split |
| -------- | ---------- | --------- | ------ | ------------ | -------- |
| DeepSeek-V2.5.BF16 | BF16 | - | ⏳ Processing | ⚪ Static | -
| DeepSeek-V2.5.FP16 | F16 | - | ⏳ Processing | ⚪ Static | -
| [DeepSeek-V2.5.Q8_0/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q8_0) | Q8_0 | 250.62GB | ✅ Available | ⚪ Static | ✂ Yes
| [DeepSeek-V2.5.Q6_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q6_K) | Q6_K | 193.54GB | ✅ Available | ⚪ Static | ✂ Yes
| [DeepSeek-V2.5.Q5_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q5_K) | Q5_K | 167.22GB | ✅ Available | ⚪ Static | ✂ Yes
| [DeepSeek-V2.5.Q5_K_S/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q5_K_S) | Q5_K_S | 162.31GB | ✅ Available | ⚪ Static | ✂ Yes
| [DeepSeek-V2.5.Q4_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q4_K) | Q4_K | 142.45GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| [DeepSeek-V2.5.Q4_K_S/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q4_K_S) | Q4_K_S | 133.88GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| DeepSeek-V2.5.IQ4_NL | IQ4_NL | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ4_XS | IQ4_XS | - | ⏳ Processing | 🟢 IMatrix | -
| [DeepSeek-V2.5.Q3_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q3_K) | Q3_K | 112.67GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| [DeepSeek-V2.5.Q3_K_L/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q3_K_L) | Q3_K_L | 122.37GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| DeepSeek-V2.5.Q3_K_S | Q3_K_S | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ3_M | IQ3_M | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ3_S | IQ3_S | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ3_XS | IQ3_XS | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ3_XXS | IQ3_XXS | - | ⏳ Processing | 🟢 IMatrix | -
| [DeepSeek-V2.5.Q2_K/*](https://huggingface.co/legraphista/DeepSeek-V2.5-IMat-GGUF/tree/main/DeepSeek-V2.5.Q2_K) | Q2_K | 85.95GB | ✅ Available | 🟢 IMatrix | ✂ Yes
| DeepSeek-V2.5.Q2_K_S | Q2_K_S | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ2_M | IQ2_M | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ2_S | IQ2_S | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ2_XS | IQ2_XS | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ2_XXS | IQ2_XXS | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ1_M | IQ1_M | - | ⏳ Processing | 🟢 IMatrix | -
| DeepSeek-V2.5.IQ1_S | IQ1_S | - | ⏳ Processing | 🟢 IMatrix | -


## Downloading using huggingface-cli
If you do not have hugginface-cli installed:
```
pip install -U "huggingface_hub[cli]"
```
Download the specific file you want:
```
huggingface-cli download legraphista/DeepSeek-V2.5-IMat-GGUF --include "DeepSeek-V2.5.Q8_0.gguf" --local-dir ./
```
If the model file is big, it has been split into multiple files. In order to download them all to a local folder, run:
```
huggingface-cli download legraphista/DeepSeek-V2.5-IMat-GGUF --include "DeepSeek-V2.5.Q8_0/*" --local-dir ./
# see FAQ for merging GGUF's
```

---

## Inference

### Simple chat template
```
<|begin▁of▁sentence|><|User|>{user_prompt}<|Assistant|>{assistant_response}<|end▁of▁sentence|><|User|>{next_user_prompt}
```

### Chat template with system prompt
```
        <|begin▁of▁sentence|>{system_prompt}<|User|>{user_prompt}<|Assistant|>{assistant_response}<|end▁of▁sentence|><|User|>{next_user_prompt}
```

### Llama.cpp
```
llama.cpp/main -m DeepSeek-V2.5.Q8_0.gguf --color -i -p "prompt here (according to the chat template)"
```

---

## FAQ

### Why is the IMatrix not applied everywhere?
According to [this investigation](https://www.reddit.com/r/LocalLLaMA/comments/1993iro/ggufs_quants_can_punch_above_their_weights_now/), it appears that lower quantizations are the only ones that benefit from the imatrix input (as per hellaswag results). 

### How do I merge a split GGUF?
1. Make sure you have `gguf-split` available
    - To get hold of `gguf-split`, navigate to https://github.com/ggerganov/llama.cpp/releases
    - Download the appropriate zip for your system from the latest release
    - Unzip the archive and you should be able to find `gguf-split`
2. Locate your GGUF chunks folder (ex: `DeepSeek-V2.5.Q8_0`)
3. Run `gguf-split --merge DeepSeek-V2.5.Q8_0/DeepSeek-V2.5.Q8_0-00001-of-XXXXX.gguf DeepSeek-V2.5.Q8_0.gguf`
    - Make sure to point `gguf-split` to the first chunk of the split.

---

Got a suggestion? Ping me [@legraphista](https://x.com/legraphista)!