π Model Description
base_model: google/gemma-3n-E2B-it language:
- en
- gemma3
- unsloth
- transformers
- gemma
Learn how to run & fine-tune Gemma 3n correctly - Read our Guide.
See our collection for all versions of Gemma 3n including GGUF, 4-bit & 16-bit formats.
Unsloth Dynamic 2.0 achieves SOTA accuracy & performance versus other quants.
β¨ Gemma 3n Usage Guidelines
- Currently only text is supported.
- Ollama:
ollama run hf.co/unsloth/gemma-3n-E4B-it-GGUF:Q4KXL
- auto-sets correct chat template and settings - Set temperature = 1.0, topk = 64, topp = 0.95, min_p = 0.0
- Gemma 3n max tokens (context length): 32K. Gemma 3n chat template:
<bos><startofturn>user\nHello!<endofturn>\n<startofturn>model\nHey there!<endofturn>\n<startofturn>user\nWhat is 1+1?<endofturn>\n<startofturn>model\n
- For complete detailed instructions, see our step-by-step guide.
π¦₯ Fine-tune Gemma 3n with Unsloth
- Fine-tune Gemma 3n (4B) for free using our Google Colab notebook here!
- Read our Blog about Gemma 3n support: unsloth.ai/blog/gemma-3n
- View the rest of our notebooks in our docs here.
Unsloth supports | Free Notebooks | Performance | Memory use |
---|---|---|---|
Gemma-3n-E4B | βΆοΈ Start on Colab | 2x faster | 60% less |
GRPO with Gemma 3 (1B) | βΆοΈ Start on Colab-GRPO.ipynb) | 2x faster | 80% less |
Gemma 3 (4B) Vision | βΆοΈ Start on Colab-Vision.ipynb) | 2x faster | 60% less |
Qwen3 (14B) | βΆοΈ Start on Colab-Reasoning-Conversational.ipynb) | 2x faster | 60% less |
DeepSeek-R1-0528-Qwen3-8B (14B) | βΆοΈ Start on ColabGRPO.ipynb) | 2x faster | 80% less |
Llama-3.2 (3B) | βΆοΈ Start on Colab-Conversational.ipynb) | 2.4x faster | 58% less |
Gemma-3n-E2B model card
Model Page: Gemma 3nResources and Technical Documentation:
Terms of Use: Terms\
Authors: Google DeepMind
Model Information
Summary description and brief definition of inputs and outputs.
Description
Gemma is a family of lightweight, state-of-the-art open models from Google,
built from the same research and technology used to create the Gemini models.
Gemma 3n models are designed for efficient execution on low-resource devices.
They are capable of multimodal input, handling text, image, video, and audio
input, and generating text outputs, with open weights for pre-trained and
instruction-tuned variants. These models were trained with data in over 140
spoken languages.
Gemma 3n models use selective parameter activation technology to reduce resource
requirements. This technique allows the models to operate at an effective size
of 2B and 4B parameters, which is lower than the total number of parameters they
contain. For more information on Gemma 3n's efficient parameter management
technology, see the
Gemma 3n
page.
Inputs and outputs
- Input:
- Output:
Usage
Below, there are some code snippets on how to get quickly started with running
the model. First, install the Transformers library. Gemma 3n is supported
starting from transformers 4.53.0.
$ pip install -U transformers
Then, copy the snippet from the section that is relevant for your use case.
#### Running with the pipeline
API
You can initialize the model and processor for inference with pipeline
as
follows.
from transformers import pipeline
import torch
pipe = pipeline(
"image-text-to-text",
model="google/gemma-3n-e4b-it",
device="cuda",
torch_dtype=torch.bfloat16,
)
With instruction-tuned models, you need to use chat templates to process our
inputs first. Then, you can pass it to the pipeline.
messages = [
{
"role": "system",
"content": [{"type": "text", "text": "You are a helpful assistant."}]
},
{
"role": "user",
"content": [
{"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
{"type": "text", "text": "What animal is on the candy?"}
]
}
]
output = pipe(text=messages, maxnewtokens=200)
print(output[0]["generated_text"][-1]["content"])
Okay, let's take a look!
Based on the image, the animal on the candy is a turtle.
You can see the shell shape and the head and legs.
#### Running the model on a single GPU
from transformers import AutoProcessor, Gemma3nForConditionalGeneration
from PIL import Image
import requests
import torch
model_id = "google/gemma-3n-e4b-it"
model = Gemma3nForConditionalGeneration.frompretrained(modelid, devicemap="auto", torchdtype=torch.bfloat16,).eval()
processor = AutoProcessor.frompretrained(modelid)
messages = [
{
"role": "system",
"content": [{"type": "text", "text": "You are a helpful assistant."}]
},
{
"role": "user",
"content": [
{"type": "image", "image": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/bee.jpg"},
{"type": "text", "text": "Describe this image in detail."}
]
}
]
inputs = processor.applychattemplate(
messages,
addgenerationprompt=True,
tokenize=True,
return_dict=True,
return_tensors="pt",
).to(model.device)
inputlen = inputs["inputids"].shape[-1]
with torch.inference_mode():
generation = model.generate(inputs, maxnewtokens=100, do_sample=False)
generation = generation[0][input_len:]
decoded = processor.decode(generation, skipspecialtokens=True)
print(decoded)
Overall Impression: The image is a close-up shot of a vibrant garden scene,
focusing on a cluster of pink cosmos flowers and a busy bumblebee.
It has a slightly soft, natural feel, likely captured in daylight.
Citation
@article{gemma3n2025,
title={Gemma 3n},
url={https://ai.google.dev/gemma/docs/gemma-3n},
publisher={Google DeepMind},
author={Gemma Team},
year={2025}
}
Model Data
Data used for model training and how the data was processed.
Training Dataset
These models were trained on a dataset that includes a wide variety of sources
totalling approximately 11 trillion tokens. The knowledge cutoff date for the
training data was June 2024. Here are the key components:
- Web Documents: A diverse collection of web text ensures the model
- Code: Exposing the model to code helps it to learn the syntax and
- Mathematics: Training on mathematical text helps the model learn
- Images: A wide range of images enables the model to perform image
- Audio: A diverse set of sound samples enables the model to recognize
Data Preprocessing
Here are the key data cleaning and filtering methods applied to the training
data:
- CSAM Filtering: Rigorous CSAM (Child Sexual Abuse Material)
- Sensitive Data Filtering: As part of making Gemma pre-trained models
- Additional methods: Filtering based on content quality and safety in
Implementation Information
Details about the model internals.
Hardware
Gemma was trained using Tensor Processing Unit
(TPU) hardware (TPUv4p, TPUv5p
and TPUv5e). Training generative models requires significant computational
power. TPUs, designed specifically for matrix operations common in machine
learning, offer several advantages in this domain:
- Performance: TPUs are specifically designed to handle the massive
- Memory: TPUs often come with large amounts of high-bandwidth memory,
- Scalability: TPU Pods (large clusters of TPUs) provide a scalable
- Cost-effectiveness: In many scenarios, TPUs can provide a more
Software
Training was done using JAX and
ML Pathways.
JAX allows researchers to take advantage of the latest generation of hardware,
including TPUs, for faster and more efficient training of large models. ML
Pathways is Google's latest effort to build artificially intelligent systems
capable of generalizing across multiple tasks. This is specially suitable for
foundation models, including large language models like these ones.
Together, JAX and ML Pathways are used as described in the
paper about the Gemini family of models:
*"the 'single controller' programming model of Jax and Pathways allows a single
Python process to orchestrate the entire training run, dramatically simplifying
the development workflow."*
Evaluation
Model evaluation metrics and results.
Benchmark Results
These models were evaluated at full precision (float32) against a large
collection of different datasets and metrics to cover different aspects of
content generation. Evaluation results marked with IT are for
instruction-tuned models. Evaluation results marked with PT are for
pre-trained models.
#### Reasoning and factuality
Benchmark | Metric | n-shot | E2B PT | E4B PT |
---|---|---|---|---|
[HellaSwag][hellaswag] | Accuracy | 10-shot | 72.2 | 78.6 |
[BoolQ][boolq] | Accuracy | 0-shot | 76.4 | 81.6 |
[PIQA][piqa] | Accuracy | 0-shot | 78.9 | 81.0 |
[SocialIQA][socialiqa] | Accuracy | 0-shot | 48.8 | 50.0 |
[TriviaQA][triviaqa] | Accuracy | 5-shot | 60.8 | 70.2 |
[Natural Questions][naturalq] | Accuracy | 5-shot | 15.5 | 20.9 |
[ARC-c][arc] | Accuracy | 25-shot | 51.7 | 61.6 |
[ARC-e][arc] | Accuracy | 0-shot | 75.8 | 81.6 |
[WinoGrande][winogrande] | Accuracy | 5-shot | 66.8 | 71.7 |
[BIG-Bench Hard][bbh] | Accuracy | few-shot | 44.3 | 52.9 |
[DROP][drop] | Token F1 score | 1-shot | 53.9 | 60.8 |
#### Multilingual
Benchmark | Metric | n-shot | E2B IT | E4B IT |
---|---|---|---|---|
[MGSM][mgsm] | Accuracy | 0-shot | 53.1 | 60.7 |
[WMT24++][wmt24pp] (ChrF) | Character-level F-score | 0-shot | 42.7 | 50.1 |
[Include][include] | Accuracy | 0-shot | 38.6 | 57.2 |
[MMLU][mmlu] (ProX) | Accuracy | 0-shot | 8.1 | 19.9 |
[OpenAI MMLU][openai-mmlu] | Accuracy | 0-shot | 22.3 | 35.6 |
[Global-MMLU][global-mmlu] | Accuracy | 0-shot | 55.1 | 60.3 |
[ECLeKTic][eclektic] | ECLeKTic score | 0-shot | 2.5 | 1.9 |
#### STEM and code
Benchmark | Metric | n-shot | E2B IT | E4B IT |
---|---|---|---|---|
[GPQA][gpqa] Diamond | RelaxedAccuracy/accuracy | 0-shot | 24.8 | 23.7 |
[LiveCodeBench][lcb] v5 | pass@1 | 0-shot | 18.6 | 25.7 |
Codegolf v2.2 | pass@1 | 0-shot | 11.0 | 16.8 |
[AIME 2025][aime-2025] | Accuracy | 0-shot | 6.7 | 11.6 |
#### Additional benchmarks
Benchmark | Metric | n-shot | E2B IT | E4B IT |
---|---|---|---|---|
[MMLU][mmlu] | Accuracy | 0-shot | 60.1 | 64.9 |
[MBPP][mbpp] | pass@1 | 3-shot | 56.6 | 63.6 |
[HumanEval][humaneval] | pass@1 | 0-shot | 66.5 | 75.0 |
[LiveCodeBench][lcb] | pass@1 | 0-shot | 13.2 | 13.2 |
HiddenMath | Accuracy | 0-shot | 27.7 | 37.7 |
[Global-MMLU-Lite][global-mmlu-lite] | Accuracy | 0-shot | 59.0 | 64.5 |
[MMLU][mmlu] (Pro) | Accuracy | 0-shot | 40.5 | 50.6 |
Ethics and Safety
Ethics and safety evaluation approach and results.
Evaluation Approach
Our evaluation methods include structured evaluations and internal red-teaming
testing of relevant content policies. Red-teaming was conducted by a number of
different teams, each with different goals and human evaluation metrics. These
models were evaluated against a number of different categories relevant to
ethics and safety, including:
- Child Safety: Evaluation of text-to-text and image to text prompts
- Content Safety: Evaluation of text-to-text and image to text prompts
- Representational Harms: Evaluation of text-to-text and image to text
Evaluation Results
For all areas of safety testing, we saw safe levels of performance across the
categories of child safety, content safety, and representational harms relative
to previous Gemma models. All testing was conducted without safety filters to
evaluate the model capabilities and behaviors. For text-to-text, image-to-text,
and audio-to-text, and across all model sizes, the model produced minimal policy
violations, and showed significant improvements over previous Gemma models'
performance with respect to high severity violations. A limitation of our
evaluations was they included primarily English language prompts.
Usage and Limitations
These models have certain limitations that users should be aware of.
Intended Usage
Open generative models have a wide range of applications across various
industries and domains. The following list of potential uses is not
comprehensive. The purpose of this list is to provide contextual information
about the possible use-cases that the model creators considered as part of model
training and development.
- Content Creation and Communication
- Research and Education
Limitations
- Training Data
- Context and Task Complexity
- Language Ambiguity and Nuance
- Factual Accuracy
- Common Sense
Ethical Considerations and Risks
The development of generative models raises several ethical concerns. In
creating an open model, we have carefully considered the following:
- Bias and Fairness
- Misinformation and Misuse
- Transparency and Accountability:
- Perpetuation of biases: It's encouraged to perform continuous monitoring
- Generation of harmful content: Mechanisms and guidelines for content
- Misuse for malicious purposes: Technical limitations and developer
- Privacy violations: Models were trained on data filtered for removal of
Benefits
At the time of release, this family of models provides high-performance open
generative model implementations designed from the ground up for responsible AI
development compared to similarly sized models.
Using the benchmark evaluation metrics described in this document, these models
have shown to provide superior performance to other, comparably-sized open model
alternatives.
π GGUF File List
π Filename | π¦ Size | β‘ Download |
---|---|---|
gemma-3n-E2B-it-F16.gguf
LFS
FP16
|
8.31 GB | Download |
gemma-3n-E2B-it-IQ4_NL.gguf
LFS
Q4
|
2.76 GB | Download |
gemma-3n-E2B-it-IQ4_XS.gguf
LFS
Q4
|
2.71 GB | Download |
gemma-3n-E2B-it-Q2_K.gguf
LFS
Q2
|
2.07 GB | Download |
gemma-3n-E2B-it-Q2_K_L.gguf
LFS
Q2
|
2.07 GB | Download |
gemma-3n-E2B-it-Q3_K_M.gguf
LFS
Q3
|
2.31 GB | Download |
gemma-3n-E2B-it-Q3_K_S.gguf
LFS
Q3
|
2.23 GB | Download |
gemma-3n-E2B-it-Q4_0.gguf
Recommended
LFS
Q4
|
2.76 GB | Download |
gemma-3n-E2B-it-Q4_1.gguf
LFS
Q4
|
2.87 GB | Download |
gemma-3n-E2B-it-Q4_K_M.gguf
LFS
Q4
|
2.82 GB | Download |
gemma-3n-E2B-it-Q4_K_S.gguf
LFS
Q4
|
2.77 GB | Download |
gemma-3n-E2B-it-Q5_K_M.gguf
LFS
Q5
|
3.07 GB | Download |
gemma-3n-E2B-it-Q5_K_S.gguf
LFS
Q5
|
3.04 GB | Download |
gemma-3n-E2B-it-Q6_K.gguf
LFS
Q6
|
3.92 GB | Download |
gemma-3n-E2B-it-Q8_0.gguf
LFS
Q8
|
4.46 GB | Download |
gemma-3n-E2B-it-UD-IQ2_M.gguf
LFS
Q2
|
2.04 GB | Download |
gemma-3n-E2B-it-UD-IQ2_XXS.gguf
LFS
Q2
|
1.91 GB | Download |
gemma-3n-E2B-it-UD-IQ3_XXS.gguf
LFS
Q3
|
2.16 GB | Download |
gemma-3n-E2B-it-UD-Q2_K_XL.gguf
LFS
Q2
|
2.44 GB | Download |
gemma-3n-E2B-it-UD-Q3_K_XL.gguf
LFS
Q3
|
2.65 GB | Download |
gemma-3n-E2B-it-UD-Q4_K_XL.gguf
LFS
Q4
|
3.5 GB | Download |
gemma-3n-E2B-it-UD-Q5_K_XL.gguf
LFS
Q5
|
3.74 GB | Download |
gemma-3n-E2B-it-UD-Q6_K_XL.gguf
LFS
Q6
|
4.16 GB | Download |
gemma-3n-E2B-it-UD-Q8_K_XL.gguf
LFS
Q8
|
6.96 GB | Download |