README.md

---
base_model: google/shieldgemma-27b
extra_gated_button_content: Acknowledge license
extra_gated_heading: Access Gemma on Hugging Face
extra_gated_prompt: "To access Gemma on Hugging Face, you\u2019re required to review\
  \ and agree to Google\u2019s usage license. To do this, please ensure you\u2019\
  re logged in to Hugging Face and click below. Requests are processed immediately."
inference: false
library_name: gguf
license: gemma
pipeline_tag: text-generation
quantized_by: legraphista
tags:
- quantized
- GGUF
- quantization
- imat
- imatrix
- static
- 16bit
- 8bit
- 6bit
- 5bit
- 4bit
- 3bit
- 2bit
- 1bit
---

# shieldgemma-27b-IMat-GGUF
_Llama.cpp imatrix quantization of google/shieldgemma-27b_

Original Model: [google/shieldgemma-27b](https://huggingface.co/google/shieldgemma-27b)    
Original dtype: `BF16` (`bfloat16`)  
Quantized by:  llama.cpp [b3525](https://github.com/ggerganov/llama.cpp/releases/tag/b3525)  
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)
    - [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/shieldgemma-27b-IMat-GGUF/blob/main/imatrix.dat)

### Common Quants
| Filename | Quant type | File Size | Status | Uses IMatrix | Is Split |
| -------- | ---------- | --------- | ------ | ------------ | -------- |
| [shieldgemma-27b.Q8_0.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q8_0.gguf) | Q8_0 | 28.94GB | ✅ Available | ⚪ Static | 📦 No
| [shieldgemma-27b.Q6_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q6_K.gguf) | Q6_K | 22.34GB | ✅ Available | ⚪ Static | 📦 No
| [shieldgemma-27b.Q4_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q4_K.gguf) | Q4_K | 16.65GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q3_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q3_K.gguf) | Q3_K | 13.42GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q2_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q2_K.gguf) | Q2_K | 10.45GB | ✅ Available | 🟢 IMatrix | 📦 No


### All Quants
| Filename | Quant type | File Size | Status | Uses IMatrix | Is Split |
| -------- | ---------- | --------- | ------ | ------------ | -------- |
| [shieldgemma-27b.BF16/*](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/tree/main/shieldgemma-27b.BF16) | BF16 | 54.46GB | ✅ Available | ⚪ Static | ✂ Yes
| [shieldgemma-27b.FP16/*](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/tree/main/shieldgemma-27b.FP16) | F16 | 54.46GB | ✅ Available | ⚪ Static | ✂ Yes
| [shieldgemma-27b.Q8_0.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q8_0.gguf) | Q8_0 | 28.94GB | ✅ Available | ⚪ Static | 📦 No
| [shieldgemma-27b.Q6_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q6_K.gguf) | Q6_K | 22.34GB | ✅ Available | ⚪ Static | 📦 No
| [shieldgemma-27b.Q5_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q5_K.gguf) | Q5_K | 19.41GB | ✅ Available | ⚪ Static | 📦 No
| [shieldgemma-27b.Q5_K_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q5_K_S.gguf) | Q5_K_S | 18.88GB | ✅ Available | ⚪ Static | 📦 No
| [shieldgemma-27b.Q4_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q4_K.gguf) | Q4_K | 16.65GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q4_K_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q4_K_S.gguf) | Q4_K_S | 15.74GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ4_NL.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ4_NL.gguf) | IQ4_NL | 15.63GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ4_XS.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ4_XS.gguf) | IQ4_XS | 14.81GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q3_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q3_K.gguf) | Q3_K | 13.42GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q3_K_L.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q3_K_L.gguf) | Q3_K_L | 14.52GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q3_K_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q3_K_S.gguf) | Q3_K_S | 12.17GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ3_M.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ3_M.gguf) | IQ3_M | 12.45GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ3_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ3_S.gguf) | IQ3_S | 12.17GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ3_XS.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ3_XS.gguf) | IQ3_XS | 11.55GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ3_XXS.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ3_XXS.gguf) | IQ3_XXS | 10.75GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q2_K.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q2_K.gguf) | Q2_K | 10.45GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.Q2_K_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.Q2_K_S.gguf) | Q2_K_S | 9.72GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ2_M.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ2_M.gguf) | IQ2_M | 9.40GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ2_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ2_S.gguf) | IQ2_S | 8.65GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ2_XS.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ2_XS.gguf) | IQ2_XS | 8.40GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ2_XXS.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ2_XXS.gguf) | IQ2_XXS | 7.63GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ1_M.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ1_M.gguf) | IQ1_M | 6.69GB | ✅ Available | 🟢 IMatrix | 📦 No
| [shieldgemma-27b.IQ1_S.gguf](https://huggingface.co/legraphista/shieldgemma-27b-IMat-GGUF/blob/main/shieldgemma-27b.IQ1_S.gguf) | IQ1_S | 6.13GB | ✅ Available | 🟢 IMatrix | 📦 No


## 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/shieldgemma-27b-IMat-GGUF --include "shieldgemma-27b.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/shieldgemma-27b-IMat-GGUF --include "shieldgemma-27b.Q8_0/*" --local-dir ./
# see FAQ for merging GGUF's
```

---

## Inference

### Simple chat template
```
<bos>You are a policy expert trying to help determine whether a user prompt is in violation of the defined safety policies.

<start_of_turn>
Human Question: {next_user_prompt}
<end_of_turn>

Our safety principle is defined in the below:

* {guideline}

===

Does the human question violate the above principle? Your answer must start with 'Yes' or 'No'. And then walk through step by step to be sure we answer correctly.


```

### Llama.cpp
```
llama.cpp/main -m shieldgemma-27b.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: `shieldgemma-27b.Q8_0`)
3. Run `gguf-split --merge shieldgemma-27b.Q8_0/shieldgemma-27b.Q8_0-00001-of-XXXXX.gguf shieldgemma-27b.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)!