README.md

---
pipeline_tag: text-generation
license: gemma
base_model: google/gemma-2b
library_name: kerasformers
extra_gated_heading: Access Gemma on Hugging Face
language:
- en
tags:
- keras
- kerasformers
- gemma
- gemma-2b
- text-generation
- arxiv:2403.08295
- pytorch
- jax
- tf
---

*See [our collection](https://huggingface.co/kerasformers) for all Gemma sizes and variants.*

# Run Gemma with Keras 3: JAX, PyTorch, or TensorFlow

[![GitHub](https://img.shields.io/badge/GitHub-KerasFormers-181717?logo=github)](https://github.com/IMvision12/KerasFormers) [![Docs](https://img.shields.io/badge/Docs-Gemma-1f6feb)](https://imvision12.github.io/KerasFormers/gemma/) [![HuggingFace](https://img.shields.io/badge/HuggingFace-Gemma-ffd21e?logo=huggingface&logoColor=black)](https://huggingface.co/kerasformers)

# kerasformers/gemma-2b

Pure-**Keras 3** conversion of [`google/gemma-2b`](https://huggingface.co/google/gemma-2b) for
[kerasformers](https://github.com/IMvision12/KerasFormers). One implementation runs unmodified on
**TensorFlow / Torch / JAX**. This is a base (pretrained) checkpoint, served here as **text -> text** via `GemmaTextGenerate`; weights are
stored in **bfloat16**.

For model details, license, and usage terms, see Google's
[model card](https://huggingface.co/google/gemma-2b).

## ✨ Quick start

```python
import os
os.environ["KERAS_BACKEND"] = "torch"  # or "jax" / "tensorflow"

from kerasformers.models.gemma import GemmaTextGenerate, GemmaTokenizer

model = GemmaTextGenerate.from_weights("kerasformers/gemma-2b")
tokenizer = GemmaTokenizer.from_weights("kerasformers/gemma-2b")

inputs = tokenizer([{"role": "user", "content": "Hello, who are you?"}])
outputs = model.generate(**inputs, max_new_tokens=64)
print(tokenizer.decode(outputs[0]))
```

Load any Gemma variant the same way with `from_weights("kerasformers/<variant>")`:

| Variant | Hub |
| --- | --- |
| `gemma-1.1-2b-it` | [kerasformers/gemma-1.1-2b-it](https://huggingface.co/kerasformers/gemma-1.1-2b-it) |
| `gemma-1.1-7b-it` | [kerasformers/gemma-1.1-7b-it](https://huggingface.co/kerasformers/gemma-1.1-7b-it) |
| `gemma-2b` | [kerasformers/gemma-2b](https://huggingface.co/kerasformers/gemma-2b) |
| `gemma-2b-it` | [kerasformers/gemma-2b-it](https://huggingface.co/kerasformers/gemma-2b-it) |
| `gemma-7b` | [kerasformers/gemma-7b](https://huggingface.co/kerasformers/gemma-7b) |
| `gemma-7b-it` | [kerasformers/gemma-7b-it](https://huggingface.co/kerasformers/gemma-7b-it) |

## Tips

- Set `KERAS_BACKEND` **before** importing Keras / kerasformers.
- Loads in **bfloat16** by default. Pass `load_dtype="float32"` for full precision,
  or `quantization="int8"` to shrink further.
- See the [Gemma docs](https://imvision12.github.io/KerasFormers/gemma/).
- Community / upstream weights still work via the `hf:` prefix:
  `GemmaTextGenerate.from_weights("hf:google/gemma-2b")`.

## Special Thanks

A huge thank you to the Google Gemma authors for creating and releasing these models.

License: Gemma (gated). Accept the license on the upstream Hub card before downloading.