gemma-4-31B-it
Image input
- Parameters
- 30.7B
- Max context length
- 262,144
- Architecture
- gemma4
- License
- Commercial OK
- Base model
- google/gemma-4-31B-it
- License
- apache-2.0
- llama.cpp
- b8637+
About gemma-4-31B-it
gemma-4-31B-it is a GGUF model based on google/gemma-4-31B-it on Hugging Face. GGUF files are published by 4 sources (unsloth/gemma-4-31B-it-GGUF, ggml-org/gemma-4-31B-it-GGUF, bartowski/google_gemma-4-31B-it-GGUF and others). It has about 30.7B parameters, the gemma4 architecture, a maximum context length of 262,144 tokens (values written in the GGUF).
There are 37 quantizations, with file sizes from 8.53 GB (UD-IQ2_XXS) to 61.4 GB (BF16) (actual sizes on Hugging Face).
Running Q4_K_M (18.3 GB) with an 8,192-token context needs an estimated 21.3 GB of memory, and an estimated 23.3 GB at 32,768 tokens. For 8,192 tokens, a GPU with 24 GB or more of VRAM (such as GeForce RTX 3090 Ti, GeForce RTX 4090), or a Mac with 24 GB or more of unified memory, is a rough guide (macOS caps how much memory the GPU can use, so leave some headroom). The smallest, UD-IQ2_XXS (8.53 GB), needs an estimated 11.5 GB at 8,192 tokens.
The original model is licensed under Apache License 2.0, which allows commercial use (keep the license text and copyright notice when redistributing). Check the original license for the terms of use. An mmproj file for image input is also available.
File size and estimated memory per quantization
- Up to 8 GB
- Up to 16 GB
- Up to 24 GB
- Up to 48 GB
- Up to 128 GB
- More
File sizes are the actual values on Hugging Face. Memory is estimated for each context length (KV cache f16). The formula is in How memory is calculated.
All memory figures are Estimated (KV cache f16). It should run on a setup with at least this much VRAM (or Mac unified memory). Click a value to see the devices and models that fit that amount (Find by GPU / Mac).
4 sources publish GGUF files of this model. Quantization types and file sizes differ slightly between sources, so there is a table for each source below.
Using image input: This model supports image input. To use images, an mmproj file is loaded as well.
About the "quality guide" (how far a quantization drifts from the original)
For each quantization type, how far the output drifts from the original model, grouped into six levels from values llama.cpp measured on Llama-3-8B.
The value is mean KLD (the difference between the original and quantized model in next-token probabilities); smaller means closer to the original. Quantizations made with an imatrix (importance data) come out slightly smaller. Levels use the value without an imatrix (or with one, for types that only have that).
These values were not measured on this model. Larger models and MoE models tend to drift less with the same type. Distributor-specific mixed types (such as UD-Q4_K_XL) cannot be matched by type name alone, so they show "-".
| Quantization | Quality guide | KLD (no imatrix) | KLD (imatrix) | Size (Llama-3-8B) |
|---|---|---|---|---|
| Q8_0 | Nearly identical | 0.0014 | - | 7.96 GiB |
| Q6_K | Very small | 0.0055 | - | 6.14 GiB |
| Q5_K_M | Very small | 0.0108 | - | 5.33 GiB |
| Q5_K_S | Small | 0.0166 | - | 5.21 GiB |
| Q5_1 | Small | 0.0180 | - | 5.65 GiB |
| Q5_0 | Small | 0.0222 | - | 5.21 GiB |
| Q4_K_M | Small | 0.0313 | 0.0282 | 4.58 GiB |
| Q4_K_S | Medium | 0.0431 | 0.0320 | 4.37 GiB |
| IQ4_NL | Small | - | 0.0357 | 4.35 GiB |
| IQ4_XS | Small | - | 0.0363 | 4.14 GiB |
| Q4_1 | Medium | 0.0717 | - | 4.78 GiB |
| Q4_0 | Medium | 0.0719 | - | 4.34 GiB |
| Q3_K_L | Medium | 0.0872 | 0.0731 | 4.03 GiB |
| Q3_K_M | Medium | 0.1019 | 0.0844 | 3.74 GiB |
| IQ3_M | Medium | - | 0.1025 | 3.53 GiB |
| IQ3_S | Medium | - | 0.1113 | 3.42 GiB |
| IQ3_XS | Large | - | 0.1387 | 3.28 GiB |
| IQ3_XXS | Large | - | 0.1836 | 3.05 GiB |
| Q3_K_S | Large | 0.2282 | 0.1998 | 3.41 GiB |
| IQ2_M | Large | - | 0.3260 | 2.74 GiB |
| Q2_K | Very large | 0.4451 | 0.3322 | 2.96 GiB |
| Q2_K_S | Very large | - | 0.4034 | 2.96 GiB |
| IQ2_S | Very large | - | 0.4392 | 2.56 GiB |
| IQ2_XS | Very large | - | 0.5463 | 2.43 GiB |
| IQ2_XXS | Very large | - | 0.8120 | 2.24 GiB |
| IQ1_M | Very large | - | 1.3931 | 2.01 GiB |
| IQ1_S | Very large | - | 2.2546 | 1.88 GiB |
Source: llama.cpp (MIT), measured on Llama-3-8B against FP16, Wikitext-2, revision f364eb6f. Original table · Reading and choosing quantizations
Last checked: Nov 11, 2026
- Architecture
- gemma4
- llama.cpp b8637 and later
- Parameters
- 30.7B
- Max context length
- 262,144
- License
- apache-2.0 Commercial OK
The mmproj file for image input (F16) is 1.20 GB Measured . It is not included in the memory above, so add it if you use images.
Ollama ollama run hf.co/unsloth/gemma-4-31B-it-GGUF:Q4_K_M
llama.cpp llama-server -hf unsloth/gemma-4-31B-it-GGUF:Q4_K_M
Last checked: Nov 11, 2026
- Architecture
- gemma4
- llama.cpp b8637 and later
- Parameters
- 30.7B
- Max context length
- 262,144
- License
- apache-2.0 Commercial OK
| Quantization | File size Measured | Quality guide | 4,096 | 8,192 | 16,384 | 32,768 | 65,536 | 131,072 | 262,144 max |
|---|---|---|---|---|---|---|---|---|---|
| Q4_0 | 18.0 GB | Medium | 20.7 GB | 21.0 GB | 21.7 GB | 23.0 GB | 25.7 GB | 31.1 GB | 41.8 GB |
| Q8_0 | 32.6 GB | Nearly identical | 35.3 GB | 35.6 GB | 36.3 GB | 37.7 GB | 40.3 GB | 45.7 GB | 56.4 GB |
| BF16 | 61.4 GB | Original precision | 64.1 GB | 64.4 GB | 65.1 GB | 66.4 GB | 69.1 GB | 74.5 GB | 85.2 GB |
The mmproj file for image input (Q8_0) is 0.81 GB Measured . It is not included in the memory above, so add it if you use images.
Ollama ollama run hf.co/ggml-org/gemma-4-31B-it-GGUF:Q4_0
llama.cpp llama-server -hf ggml-org/gemma-4-31B-it-GGUF:Q4_0
GGUF source
bartowski/google_gemma-4-31B-it-GGUF
Converted and published by a third party About this label
Last checked: Nov 11, 2026
- Architecture
- gemma4
- llama.cpp b8637 and later
- Parameters
- 30.7B
- Max context length
- 262,144
- License
- apache-2.0 Commercial OK
The mmproj file for image input (F16) is 1.20 GB Measured . It is not included in the memory above, so add it if you use images.
Ollama ollama run hf.co/bartowski/google_gemma-4-31B-it-GGUF:Q4_K_M
llama.cpp llama-server -hf bartowski/google_gemma-4-31B-it-GGUF:Q4_K_M
GGUF source
lmstudio-community/gemma-4-31B-it-GGUF
Converted and published by a third party About this label
Last checked: Nov 11, 2026
- Architecture
- gemma4
- llama.cpp b8637 and later
- Parameters
- 30.7B
- Max context length
- 262,144
- License
- apache-2.0 Commercial OK
| Quantization | File size Measured | Quality guide | 4,096 | 8,192 | 16,384 | 32,768 | 65,536 | 131,072 | 262,144 max |
|---|---|---|---|---|---|---|---|---|---|
| Q4_K_M | 18.7 GB | Small | 21.4 GB | 21.7 GB | 22.4 GB | 23.7 GB | 26.4 GB | 31.8 GB | 42.5 GB |
| Q6_K | 25.2 GB | Very small | 27.9 GB | 28.2 GB | 28.9 GB | 30.2 GB | 32.9 GB | 38.3 GB | 49.0 GB |
| Q8_0 | 32.6 GB | Nearly identical | 35.3 GB | 35.6 GB | 36.3 GB | 37.7 GB | 40.3 GB | 45.7 GB | 56.4 GB |
The mmproj file for image input (BF16) is 1.20 GB Measured . It is not included in the memory above, so add it if you use images.
Ollama ollama run hf.co/lmstudio-community/gemma-4-31B-it-GGUF:Q4_K_M
llama.cpp llama-server -hf lmstudio-community/gemma-4-31B-it-GGUF:Q4_K_M
Generation speed on common GPUs and Macs (estimated)
A rough guide to how fast Q4_K_M (18.3 GB) generates text. Each token reads the model weights once, so the upper limit is memory bandwidth ÷ file size. The guide is 60–80% of that, where most published measurements fall.
| Device | Memory bandwidth | Guide (tokens/s) Estimated | Upper limit |
|---|---|---|---|
| Radeon RX 7900 XT 20 GB | 800 GB/s | 26–35 | 44 |
| Radeon RX 7900 XTX 24 GB | 960 GB/s | 31–42 | 52 |
| GeForce RTX 5090 32 GB | 1,792 GB/s | 59–78 | 98 |
| Apple M4 32 GB | 120 GB/s | 3.9–5.2 | 6.5 |
| Apple M4 Pro 48 GB | 273 GB/s | 8.9–12 | 15 |
| Apple M5 Ultra 96 GB | 1,200 GB/s | 39–52 | 65 |
Estimates only. Prompt processing speed (limited by compute) is not included. Longer contexts and offloading part of the model to the CPU make it slower. Macs are shown only when installed memory is at least 4/3 of what is needed. Devices without published bandwidth (some GeForce cards, etc.) are not shown.
Third-party evaluations
Values from other organizations for the original model before quantization. Not this site's own rating. Values are for the original model before quantization. GGUF quantization (especially small quantizations) can lower performance.
Capabilities (Epoch AI)
144.2 141.8–146.8
Gemma 4 31B IT · Values as of Apr 2, 2026
Source: Epoch Capabilities Index (Epoch AI) (CC BY 4.0). Original leaderboard · See in ranking
License and commercial use
Apache License 2.0 Commercial OK
Allows commercial use, modification and redistribution. When redistributing, keep the license text and copyright notice, and note changes in modified files.
Based on the license on the original model's Hugging Face page. Original license text (checked Oct 18, 2026)
The summary states facts this site read from the original text and is not legal advice. Always check the original license and its latest terms before use. All licenses
How to run
Mainline llama.cpp can load this model's format (gemma4) from b8637 (Apr 2, 2026) onward. Ollama and LM Studio bundle llama.cpp internally, so an older app fails to load it with errors such as "unknown model architecture". If that happens, update the app.
Example commands using Q4_K_M. To use another quantization, replace the name with one from the table above. Commands for files from other sources are in each source's section. How to run local LLMs
Ollama
Run it by pointing directly at the GGUF on Hugging Face.
ollama run hf.co/unsloth/gemma-4-31B-it-GGUF:Q4_K_M
llama.cpp
Pass the repository and quantization name to llama-server (or llama-cli) with -hf.
llama-server -hf unsloth/gemma-4-31B-it-GGUF:Q4_K_M
LM Studio
Paste unsloth/gemma-4-31B-it-GGUF into the search box, download it, and choose the quantization from the file list.
Other models from google
-
11.9B
google
gemma-4-12B-it
- Q4_K_M size
- 7.12 GB
- Memory at 8K
- 8.83 GB
Measured Estimated VRAM 12 GB+
-
25.2B
google
gemma-4-26B-A4B-it
- UD-Q4_K_M size
- 16.9 GB
- Memory at 8K
- 18.5 GB
Measured Estimated VRAM 24 GB+
-
7.5B
google
gemma-4-E4B-it-qat-q4_0
- Q4_0 size
- 5.15 GB
- Memory at 8K
- 6.40 GB
Measured Estimated VRAM 6 GB+
-
11.9B
google
gemma-4-12B-it-qat-q4_0
- Q4_0 size
- 6.98 GB
- Memory at 8K
- 8.69 GB
Measured Estimated VRAM 12 GB+
-
7.5B
google
gemma-4-E4B-it
- Q4_K_M size
- 4.98 GB
- Memory at 8K
- 6.23 GB
Measured Estimated VRAM 6 GB+
-
4.6B
google
gemma-4-E2B-it
- Q4_K_M size
- 3.11 GB
- Memory at 8K
- 4.24 GB
Measured Estimated VRAM 4 GB+
Models of a similar size (other developers)
-
27.3B
Qwen
Qwen3.8-27B
- UD-Q4_K_M size
- 16.5 GB
- Memory at 8K
- 18.2 GB
Measured Estimated VRAM 24 GB+
-
35.5B
huihui-ai
Huihui-Qwen3.6-35B-A3B-abliterated-MTP
- Q2_K size
- 13.2 GB
- Memory at 8K
- 14.5 GB
Measured Estimated VRAM 16 GB+
-
35.5B
ornith-ai
Ornith-1.5-35B-A3B
- Q4_K_M size
- 21.7 GB
- Memory at 8K
- 23.0 GB
Measured Estimated VRAM 24 GB+
-
27.3B
huihui-ai
Huihui-Qwen3.8-27B-abliterated
- Q4_K_M size
- 16.6 GB
- Memory at 8K
- 18.3 GB
Measured Estimated VRAM 24 GB+
-
25.2B
farbodtavakkoli
OTel-2.0-Decision-26B-A4B-4bit
- Q4_K_M size
- 16.8 GB
- Memory at 8K
- 18.4 GB
Measured Estimated VRAM 24 GB+
-
27.3B
JonathanColetti
Qwen3.8-27B-Uncensored
- Q4_K_M size
- 16.5 GB
- Memory at 8K
- 18.3 GB
Measured Estimated VRAM 24 GB+
Frequently asked questions
- How much memory do I need to run gemma-4-31B-it (Q4_K_M)?
- The file size is 18.3 GB (measured). With a 8,192-token context, the estimated memory including the KV cache is 21.3 GB. The formula is published at https://localllm.az-arte.com/en/guide/memory-calculation.
- Can gemma-4-31B-it be used commercially?
- The original model's license is Apache License 2.0 (Commercial use allowed).Allows commercial use, modification and redistribution. When redistributing, keep the license text and copyright notice, and note changes in modified files. Check the original license text before deciding.
- Does gemma-4-31B-it run in 8 GB, 12 GB, 16 GB or 24 GB of VRAM?
- 8 GB: no quantization fits; 12 GB: up to UD-IQ2_XXS (est. 11.5 GB); 16 GB: up to Q3_K_S (est. 16.2 GB); 24 GB: up to UD-Q5_K_XL (est. 24.9 GB) (estimated at 8,192 tokens with an f16 KV cache, files from the most-downloaded source).
- What is the command to run gemma-4-31B-it with Ollama?
- Run "ollama run hf.co/unsloth/gemma-4-31B-it-GGUF:Q4_K_M" to use the GGUF on Hugging Face directly. To use another quantization, replace the name at the end.