Add verified NVFP4 and matching MTP assistant assets

.gitattributes

@@ -39,3 +39,4 @@ gguf/mmproj-Winnow-E4B.gguf filter=lfs diff=lfs merge=lfs -text
 assets/e4b-profiles.png filter=lfs diff=lfs merge=lfs -text
 assets/e4b-quality.png filter=lfs diff=lfs merge=lfs -text
 assets/e4b-speed-memory.png filter=lfs diff=lfs merge=lfs -text
+gguf/Gemma-4-E4B-IT-Assistant-BF16.gguf filter=lfs diff=lfs merge=lfs -text

SHA256SUMS

@@ -1,3 +1,4 @@
 840e3f50e5a9c218727f44e121d1b37cc9e2c3b318c8eb422ba6ef2e27b618a2  gguf/Winnow-E4B-Q8_0.gguf
 53c3e504c061f6a7ce84cb6240d427ac6c630850a2cf93f3c2ee980c8136e7e7  gguf/Winnow-E4B-BF16.gguf
 ddf46c21d7078e95338cfc22306b19b276a29a5ad089023449dd54d4b6170a51  gguf/mmproj-Winnow-E4B.gguf
+4e3c9d335b248ced9bd3e0584547efca30dbf6cfd0debb810613f811a575162a  gguf/Gemma-4-E4B-IT-Assistant-BF16.gguf

docs/assistants/LICENSE-APACHE-2.0.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

docs/assistants/NOTICE.txt

@@ -0,0 +1,2 @@
+Official Gemma 4 MTP assistant models by Google DeepMind, Apache License 2.0.
+CPU-converted BF16 GGUF files preserve the exact pinned upstream identities recorded in manifest.json. Conversion changes serialization and performs no training. Upstream cards and sanitized provenance are included. Google does not endorse Winnow. Upstream pinned repository listings contained no separate NOTICE file.

docs/assistants/README.md

@@ -0,0 +1,7 @@
+# E4B MTP assistant
+
+`Gemma-4-E4B-IT-Assistant-BF16.gguf` is a BF16 GGUF conversion of Google's official [google/gemma-4-E4B-it-assistant](https://huggingface.co/google/gemma-4-E4B-it-assistant) at revision `8d0031ea8c2109e2b1e86bb9368a4539b537f80a`. Conversion changes serialization and performs no training.
+
+File size: 171766688 bytes. SHA256: `4e3c9d335b248ced9bd3e0584547efca30dbf6cfd0debb810613f811a575162a`. The matching Winnow launcher verifies the complete file before loading; other assistant files are not silently substituted.
+
+The original [upstream model card](https://huggingface.co/google/gemma-4-E4B-it-assistant/blob/8d0031ea8c2109e2b1e86bb9368a4539b537f80a/README.md) and Apache-2.0 license apply. See LICENSE-APACHE-2.0.txt, NOTICE.txt and provenance.json in this directory for attribution and exact conversion provenance.

docs/assistants/UPSTREAM-README.md

@@ -0,0 +1,589 @@
+---
+library_name: transformers
+license: apache-2.0
+license_link: https://ai.google.dev/gemma/docs/gemma_4_license
+pipeline_tag: any-to-any
+---
+
+<div align="center">
+  <img src=https://ai.google.dev/gemma/images/gemma4_banner.png>
+</div>
+
+
+<p align="center">
+    <a href="https://huggingface.co/collections/google/gemma-4" target="_blank">Hugging Face</a> |
+    <a href="https://github.com/google-gemma" target="_blank">GitHub</a> |
+    <a href="https://ai.google.dev/gemma/docs/mtp/mtp" target="_blank">MTP Documentation</a> |
+    <a href="https://arxiv.org/abs/2607.02770" target="_blank">Technical Report</a>
+    <br>
+    <b>License</b>: <a href="https://ai.google.dev/gemma/docs/gemma_4_license" target="_blank">Apache 2.0</a> | <b>Authors</b>: <a href="https://deepmind.google/models/gemma/" target="_blank">Google DeepMind</a>
+</p>
+
+> [!Note]
+> This model card is for the Multi-Token Prediction (MTP) drafters for the Gemma 4 models. MTP is implemented by extending the base model with a smaller, faster draft model. When used in a Speculative Decoding pipeline, the draft model predicts several tokens ahead, which the target model then verifies in parallel. This results in significant decoding speedups (up to 3x) while guaranteeing the exact same quality as standard generation, making these checkpoints perfect for low-latency and on-device applications. 
+
+Gemma is a family of open models built by Google DeepMind. Gemma 4 models are multimodal, handling text and image input (with audio supported on E2B, E4B, and 12B) and generating text output. This release includes open-weights models in both pre-trained and instruction-tuned variants. Gemma 4 features a context window of up to 256K tokens and maintains multilingual support in over 140 languages. 
+
+Featuring both Dense and Mixture-of-Experts (MoE) architectures, Gemma 4 is well-suited for tasks like text generation, coding, and reasoning. The models are available in five distinct sizes: **E2B**, **E4B**, **12B**, **26B A4B**, and **31B**. Their diverse sizes make them deployable in environments ranging from high-end phones to laptops and servers, democratizing access to state-of-the-art AI.
+
+Gemma 4 introduces key **capability and architectural advancements**:
+
+* **Reasoning** – All models in the family are designed as highly capable reasoners, with configurable thinking modes.
+
+* **Extended Multimodalities** – Processes Text, Image with variable aspect ratio and resolution support (all models), Video, and Audio (featured natively on the E2B, E4B, and 12B models).
+
+* **Diverse & Efficient Architectures** – Offers Dense and Mixture-of-Experts (MoE) variants of different sizes for scalable deployment.
+
+* **Optimized for On-Device** – Smaller models are specifically designed for efficient local execution on laptops and mobile devices.
+
+* **Increased Context Window** – The small models feature a 128K context window, while the medium models support 256K.
+
+* **Enhanced Coding & Agentic Capabilities** – Achieves notable improvements in coding benchmarks alongside native function-calling support, powering highly capable autonomous agents.
+
+* **Native System Prompt Support** – Gemma 4 introduces native support for the `system` role, enabling more structured and controllable conversations.
+
+## **Models Overview**
+
+Gemma 4 models are designed to deliver frontier-level performance at each size, targeting deployment scenarios from mobile and edge devices (E2B, E4B) to consumer GPUs and workstations (12B, 26B A4B, 31B). They are well-suited for reasoning, agentic workflows, coding, and multimodal understanding.
+
+The models employ a hybrid attention mechanism that interleaves local sliding window attention with full global attention, ensuring the final layer is always global. This hybrid design delivers the processing speed and low memory footprint of a lightweight model without sacrificing the deep awareness required for complex, long-context tasks. To optimize memory for long contexts, global layers feature unified Keys and Values, and apply Proportional RoPE (p-RoPE). 
+
+### Dense Models
+
+| Property | E2B | E4B | 12B Unified | 31B Dense |
+| :---- | :---- | :---- | :---- | :---- |
+| **Total Parameters** | 2.3B effective <br> (5.1B with embeddings) | 4.5B effective <br> (8B with embeddings) | 11.95B | 30.7B |
+| **Layers** | 35 | 42 | 48 | 60 |
+| **Sliding Window** | 512 tokens | 512 tokens | 1024 tokens | 1024 tokens |
+| **Context Length** | 128K tokens | 128K tokens | 256K tokens  | 256K tokens  |
+| **Vocabulary Size** | 262K | 262K | 262K | 262K |
+| **Supported Modalities** | Text, Image, Audio | Text, Image, Audio | Text, Image, Audio | Text, Image |
+| **Vision Encoder Parameters** | *~150M* | *~150M* | - | *~550M* |
+| **Audio Encoder Parameters** | *~300M* | *~300M* | - | No Audio |
+
+The "E" in E2B and E4B stands for "effective" parameters. The smaller models incorporate Per-Layer Embeddings (PLE) to maximize parameter efficiency in on-device deployments. Rather than adding more layers or parameters to the model, PLE gives each decoder layer its own small embedding for every token. These embedding tables are large but are only used for quick lookups, which is why the effective parameter count is much smaller than the total.
+
+The "Unified" in Gemma 4 12B Unified refers to its encoder-free architecture. Other Gemma 4 models use dedicated encoders to process multimodal data before passing it to the LLM. Gemma 4 12B eliminates these encoders entirely, projecting raw image patches and audio waveforms directly into the LLM's embedding space through lightweight linear layers. This unified approach means all modalities flow straight into a single decoder-only transformer, reducing multimodal latency and allowing the entire model to be fine-tuned in one pass.
+
+### Mixture-of-Experts (MoE) Model
+
+| Property | 26B A4B MoE |
+| :---- | :---- |
+| **Total Parameters** | 25.2B |
+| **Active Parameters** | 3.8B |
+| **Layers** | 30 |
+| **Sliding Window** | 1024 tokens |
+| **Context Length** | 256K tokens |
+| **Vocabulary Size** | 262K |
+| **Expert Count** | 8 active / 128 total and 1 shared |
+| **Supported Modalities** | Text, Image |
+| **Vision Encoder Parameters** | *~550M* |
+
+The "A" in 26B A4B stands for "active parameters" in contrast to the total number of parameters the model contains. By only activating a 4B subset of parameters during inference, the Mixture-of-Experts model runs much faster than its 26B total might suggest. This makes it an excellent choice for fast inference compared to the dense 31B model since it runs almost as fast as a 4B-parameter model.
+
+## **Benchmark Results** 
+
+These models were evaluated against a large collection of different datasets and metrics to cover different aspects of text generation. Evaluation results marked in the table are for instruction-tuned models.
+
+|  | Gemma 4  31B | Gemma 4  26B A4B | Gemma 4 12B Unified | Gemma 4  E4B | Gemma 4  E2B | Gemma 3  27B (no think) |
+| :---- | :---- | :---- | :---- | :---- | :---- | :---- |
+| MMLU Pro | 85.2% | 82.6% | 77.2% | 69.4% | 60.0% | 67.6% |
+| AIME 2026 no tools | 89.2% | 88.3% | 77.5% | 42.5% | 37.5% | 20.8% |
+| LiveCodeBench v6 | 80.0% | 77.1% | 72.0% | 52.0% | 44.0% | 29.1% |
+| Codeforces ELO | 2150 | 1718 | 1659 | 940 | 633 | 110 |
+| GPQA Diamond | 84.3% | 82.3% | 78.8% | 58.6% | 43.4% | 42.4% |
+| Tau2 (average over 3) | 76.9% | 68.2% | 69.0% | 42.2% | 24.5% | 16.2% |
+| HLE no tools | 19.5% | 8.7% | 5.2% | - | - | - |
+| HLE with search | 26.5% | 17.2% | - | - | - | - |
+| BigBench Extra Hard | 74.4% | 64.8% | 53.0% | 33.1% | 21.9% | 19.3% |
+| MMMLU | 88.4% | 86.3% | 83.4% | 76.6% | 67.4% | 70.7% |
+| **Vision** |  |  |  |  |  |  |
+| MMMU Pro | 76.9% | 73.8% | 69.1% | 52.6% | 44.2% | 49.7% |
+| OmniDocBench 1.5 (average edit distance, lower is better) | 0.131 | 0.149 | 0.164 | 0.181 | 0.290 | 0.365 |
+| MATH-Vision | 85.6% | 82.4% | 79.7% | 59.5% | 52.4% | 46.0% |
+| MedXPertQA MM | 61.3% | 58.1% | 48.7% | 28.7% | 23.5% | - |
+| **Audio** |  |  |  |  |  |  |
+| CoVoST | - | - | 38.5<sup>*</sup> | 35.54 | 33.47 | - |
+| FLEURS (lower is better) | - | - | 0.069<sup>*</sup> | 0.08 | 0.09 | - |
+| **Long Context** |  |  |  |  |  |  |
+| MRCR v2 8 needle 128k (average) | 66.4% | 44.1%  | 43.4% | 25.4% | 19.1% | 13.5% |
+
+<sup>*</sup>Excluding Chinese language.
+
+## **Core Capabilities**
+
+Gemma 4 models handle a broad range of tasks across text, vision, and audio. Key capabilities include:
+
+* **Thinking** – Built-in reasoning mode that lets the model think step-by-step before answering.
+* **Long Context** – Context windows of up to 128K tokens (E2B/E4B) and 256K tokens (12B, 26B A4B/31B).
+* **Image Understanding** – Object detection, Document/PDF parsing, screen and UI understanding, chart comprehension, OCR (including multilingual), handwriting recognition, and pointing. Images can be processed at variable aspect ratios and resolutions.
+* **Video Understanding** – Analyze video by processing sequences of frames.
+* **Interleaved Multimodal Input** – Freely mix text and images in any order within a single prompt.
+* **Function Calling** – Native support for structured tool use, enabling agentic workflows.
+* **Coding** – Code generation, completion, and correction.
+* **Multilingual** – Out-of-the-box support for 35+ languages, pre-trained on 140+ languages.
+* **Audio** (E2B, E4B, and 12B only) – Automatic speech recognition (ASR) and speech-to-translated-text translation across multiple languages.
+
+
+## Getting Started
+
+You can use all Gemma 4 models with the latest version of Transformers. To get started, install the necessary dependencies in your environment:
+
+`pip install -U transformers torch accelerate`
+
+Once you have everything installed, you can proceed to load the target model and the assistant model with the code below:
+
+```python
+from transformers import AutoProcessor, AutoModelForCausalLM
+
+TARGET_MODEL_ID = "google/gemma-4-E4B-it"
+ASSISTANT_MODEL_ID = "google/gemma-4-E4B-it-assistant"
+
+# Target Model
+processor = AutoProcessor.from_pretrained(TARGET_MODEL_ID)
+target_model = AutoModelForCausalLM.from_pretrained(
+    TARGET_MODEL_ID,
+    dtype="auto",
+    device_map="auto",
+
+)
+
+# Assistant Model (the drafter)
+assistant_model = AutoModelForCausalLM.from_pretrained(
+    ASSISTANT_MODEL_ID,
+    dtype="auto",
+    device_map="auto",
+)
+```
+
+Once the models are loaded, you can start generating output:
+
+```python
+# Prompt
+messages = [
+    {"role": "system", "content": "You are a helpful assistant."},
+    {"role": "user", "content": "Write a short joke about saving RAM."},
+]
+
+# Process input
+inputs = processor.apply_chat_template(
+    messages,
+    tokenize=True,
+    return_dict=True,
+    return_tensors="pt",
+    add_generation_prompt=True,
+    enable_thinking=False
+).to(model.device)
+input_len = inputs["input_ids"].shape[-1]
+
+# Generate output
+outputs = target_model.generate(
+    **inputs,
+    assistant_model=assistant_model,
+    max_new_tokens=256,
+)
+response = processor.decode(outputs[0][input_len:], skip_special_tokens=False)
+
+# Parse output
+processor.parse_response(response)
+```
+
+To enable reasoning, set `enable_thinking=True` and the `parse_response` function will take care of parsing the thinking output.
+
+Below, you will also find snippets for processing audio (E2B, E4B, and 12B only), images, and video alongside text:
+
+<details>
+<summary>Code for processing Audio</summary>
+
+Make sure to install the following packages:
+
+
+`pip install -U transformers torch torchvision librosa accelerate`
+
+Once you have everything installed, you can proceed to load the target model and the assistant model with the code below:
+
+```python
+import torch
+from transformers import AutoProcessor, AutoModelForCausalLM, AutoModelForMultimodalLM
+
+TARGET_MODEL_ID = "google/gemma-4-E4B-it"
+ASSISTANT_MODEL_ID = "google/gemma-4-E4B-it-assistant"
+
+# Target Model
+processor = AutoProcessor.from_pretrained(TARGET_MODEL_ID)
+target_model = AutoModelForMultimodalLM.from_pretrained(
+    TARGET_MODEL_ID,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+
+)
+
+# Assistant Model (the drafter)
+assistant_model = AutoModelForCausalLM.from_pretrained(
+    ASSISTANT_MODEL_ID,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+)
+```
+
+Once the model is loaded, you can start generating output by directly referencing the audio URL in the prompt:
+
+
+```python
+# Prompt - add audio after text
+messages = [
+    {
+        "role": "user",
+        "content": [
+            {"type": "text", "text": "Transcribe the following speech segment in its original language. Follow these specific instructions for formatting the answer:\n* Only output the transcription, with no newlines.\n* When transcribing numbers, write the digits, i.e. write 1.7 and not one point seven, and write 3 instead of three."},
+            {"type": "audio", "audio": "https://github.com/google-gemma/cookbook/raw/refs/heads/main/apps/sample-data/journal1.wav"},
+        ]
+    }
+]
+
+# Process input
+text = processor.apply_chat_template(
+    messages, 
+    tokenize=False, 
+    add_generation_prompt=True, 
+)
+inputs = processor(text=text, return_tensors="pt").to(target_model.device)
+input_len = inputs["input_ids"].shape[-1]
+
+# Generate output
+outputs = target_model.generate(
+    **inputs,
+    assistant_model=assistant_model,
+    max_new_tokens=256,
+)
+response = processor.decode(outputs[0][input_len:], skip_special_tokens=False)
+
+# Parse output
+processor.parse_response(response)
+```
+
+</details>
+
+<details>
+<summary>Code for processing Images</summary>
+
+Make sure to install the following packages:
+
+
+`pip install -U transformers torch torchvision accelerate`
+
+Once you have everything installed, you can proceed to load the target model and the assistant model with the code below:
+
+```python
+import torch
+from transformers import AutoProcessor, AutoModelForCausalLM, AutoModelForMultimodalLM
+
+TARGET_MODEL_ID = "google/gemma-4-E4B-it"
+ASSISTANT_MODEL_ID = "google/gemma-4-E4B-it-assistant"
+
+# Target Model
+processor = AutoProcessor.from_pretrained(TARGET_MODEL_ID)
+target_model = AutoModelForMultimodalLM.from_pretrained(
+    TARGET_MODEL_ID,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+
+)
+
+# Assistant Model (the drafter)
+assistant_model = AutoModelForCausalLM.from_pretrained(
+    ASSISTANT_MODEL_ID,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+)
+```
+
+Once the model is loaded, you can start generating output by directly referencing the image URL in the prompt:
+
+
+```python
+# Prompt - add image before text
+messages = [
+    {
+        "role": "user", "content": [
+            {"type": "image", "url": "https://raw.githubusercontent.com/google-gemma/cookbook/refs/heads/main/apps/sample-data/GoldenGate.png"},
+            {"type": "text", "text": "What is shown in this image?"}
+        ]
+    }
+]
+
+# Process input
+inputs = processor.apply_chat_template(
+    messages,
+    tokenize=True,
+    return_dict=True,
+    return_tensors="pt",
+    add_generation_prompt=True,
+).to(target_model.device)
+input_len = inputs["input_ids"].shape[-1]
+
+# Generate output
+outputs = target_model.generate(**inputs, max_new_tokens=512)
+response = processor.decode(outputs[0][input_len:], skip_special_tokens=False)
+
+# Parse output
+processor.parse_response(response)
+```
+
+</details>
+
+
+<details>
+<summary>Code for processing Videos</summary>
+
+Make sure to install the following packages:
+
+`pip install -U transformers torch torchvision librosa accelerate`
+
+Once you have everything installed, you can proceed to load the target model and the assistant model with the code below:
+
+```python
+import torch
+from transformers import AutoProcessor, AutoModelForCausalLM, AutoModelForMultimodalLM
+
+TARGET_MODEL_ID = "google/gemma-4-E4B-it"
+ASSISTANT_MODEL_ID = "google/gemma-4-E4B-it-assistant"
+
+# Target Model
+processor = AutoProcessor.from_pretrained(TARGET_MODEL_ID)
+target_model = AutoModelForMultimodalLM.from_pretrained(
+    TARGET_MODEL_ID,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+
+)
+
+# Assistant Model (the drafter)
+assistant_model = AutoModelForCausalLM.from_pretrained(
+    ASSISTANT_MODEL_ID,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+)
+```
+
+Once the model is loaded, you can start generating output by directly referencing the video URL in the prompt:
+
+
+```python
+# Prompt - add video before text
+messages = [
+    {
+        'role': 'user',
+        'content': [
+            {"type": "video", "video": "https://github.com/bebechien/gemma/raw/refs/heads/main/videos/ForBiggerBlazes.mp4"},
+            {'type': 'text', 'text': 'Describe this video.'}
+        ]
+    }
+]
+
+# Process input
+inputs = processor.apply_chat_template(
+    messages,
+    tokenize=True,
+    return_dict=True,
+    return_tensors="pt",
+    add_generation_prompt=True,
+).to(target_model.device)
+input_len = inputs["input_ids"].shape[-1]
+
+# Generate output
+outputs = target_model.generate(**inputs, max_new_tokens=512)
+response = processor.decode(outputs[0][input_len:], skip_special_tokens=False)
+
+# Parse output
+processor.parse_response(response)
+```
+
+</details>
+
+
+
+
+## **Best Practices**
+
+For the best performance, use these configurations and best practices:
+
+### 1. Sampling Parameters
+
+Use the following standardized sampling configuration across all use cases:
+
+* `temperature=1.0`  
+* `top_p=0.95`  
+* `top_k=64`
+
+### 2. Thinking Mode Configuration
+
+Compared to Gemma 3, the models use standard `system`, `assistant`, and `user` roles. To properly manage the thinking process, use the following control tokens:
+
+* **Trigger Thinking:** Thinking is enabled by including the `<|think|>` token at the start of the system prompt. To disable thinking, remove the token.   
+* **Standard Generation:** When thinking is enabled, the model will output its internal reasoning followed by the final answer using this structure:  
+  `<|channel>thought\n`**[Internal reasoning]**`<channel|>`  
+* **Disabled Thinking Behavior:** For all models except for the E2B and E4B variants, if thinking is disabled, the model will still generate the tags but with an empty thought block:  
+  `<|channel>thought\n<channel|>`**[Final answer]**
+
+> [!Note]
+> Note that many libraries like Transformers and llama.cpp handle the complexities of the chat template for you.
+
+### 3. Multi-Turn Conversations
+
+* **No Thinking Content in History**: In multi-turn conversations, the historical model output should only include the final response. Thoughts from previous model turns must *not be added* before the next user turn begins, with the exception of tool call turns where thinking content should be preserved.
+
+### 4. Modality order
+
+For optimal performance with multimodal inputs, place:
+
+* Image content **before** the text in your prompt.
+* Audio content **after** the text in your prompt.
+
+### 5. Variable Image Resolution
+
+Aside from variable aspect ratios, Gemma 4 supports variable image resolution through a configurable visual token budget, which controls how many tokens are used to represent an image. A higher token budget preserves more visual detail at the cost of additional compute, while a lower budget enables faster inference for tasks that don't require fine-grained understanding.
+
+* The supported token budgets are: **70**, **140**, **280**, **560**, and **1120**.  
+  * Use *lower budgets* for classification, captioning, or video understanding, where faster inference and processing many frames outweigh fine-grained detail.   
+  * Use *higher budgets* for tasks like OCR, document parsing, or reading small text.
+
+### 6. Audio
+
+Use the following prompt structures for audio processing:
+
+* **Audio Speech Recognition (ASR)**
+
+```text
+Transcribe the following speech segment in {LANGUAGE} into {LANGUAGE} text.
+
+Follow these specific instructions for formatting the answer:
+* Only output the transcription, with no newlines.
+* When transcribing numbers, write the digits, i.e. write 1.7 and not one point seven, and write 3 instead of three.
+```
+
+* **Automatic Speech Translation (AST)**
+
+```text
+Transcribe the following speech segment in {SOURCE_LANGUAGE}, then translate it into {TARGET_LANGUAGE}.
+When formatting the answer, first output the transcription in {SOURCE_LANGUAGE}, then one newline, then output the string '{TARGET_LANGUAGE}: ', then the translation in {TARGET_LANGUAGE}.
+```
+
+### 7. Audio and Video Length
+
+All models support image inputs and can process videos as frames whereas the E2B, E4B, and 12B models also support audio inputs. Audio supports a maximum length of 30 seconds. Video supports a maximum of 60 seconds assuming the images are processed at one frame per second.
+
+## **Model Data**
+
+Data used for model training and how the data was processed.
+
+### **Training Dataset**
+
+Our pre-training dataset is a large-scale, diverse collection of data encompassing a wide range of domains and modalities, which includes web documents, code, images, audio, with a cutoff date of January 2025. Here are the key components:
+
+* **Web Documents**: A diverse collection of web text ensures the model is exposed to a broad range of linguistic styles, topics, and vocabulary. The training dataset includes content in over 140 languages.  
+* **Code**: Exposing the model to code helps it to learn the syntax and patterns of programming languages, which improves its ability to generate code and understand code-related questions.  
+* **Mathematics**: Training on mathematical text helps the model learn logical reasoning, symbolic representation, and to address mathematical queries.  
+* **Images**: A wide range of images enables the model to perform image analysis and visual data extraction tasks.
+
+The combination of these diverse data sources is crucial for training a powerful multimodal model that can handle a wide variety of different tasks and data formats.
+
+### **Data Preprocessing**
+
+Here are the key data cleaning and filtering methods applied to the training data:
+
+* **CSAM Filtering**: Rigorous CSAM (Child Sexual Abuse Material) filtering was applied at multiple stages in the data preparation process to ensure the exclusion of harmful and illegal content.  
+* **Sensitive Data Filtering**: As part of making Gemma pre-trained models safe and reliable, automated techniques were used to filter out certain personal information and other sensitive data from training sets.  
+* **Additional methods**: Filtering based on content quality and safety in line with [our policies](https://ai.google/static/documents/ai-responsibility-update-published-february-2025.pdf).
+
+## **Ethics and Safety**
+
+As open models become central to enterprise infrastructure, provenance and security are paramount. Developed by Google DeepMind, Gemma 4 undergoes the same rigorous safety evaluations as our proprietary Gemini models. 
+
+### **Evaluation Approach**
+
+Gemma 4 models were developed in partnership with internal safety and responsible AI teams. A range of automated as well as human evaluations were conducted to help improve model safety. These evaluations align with [Google’s AI principles](https://ai.google/principles/), as well as safety policies, which aim to prevent our generative AI models from generating harmful content, including:
+
+* Content related to child sexual abuse material and exploitation   
+* Dangerous content (e.g., promoting suicide, or instructing in activities that could cause real-world harm)   
+* Sexually explicit content  
+* Hate speech (e.g., dehumanizing members of protected groups)   
+* Harassment (e.g., encouraging violence against people)
+
+### **Evaluation Results**
+
+For all areas of safety testing, we saw major improvements in all categories of content safety relative to previous Gemma models. Overall, Gemma 4 models significantly outperform Gemma 3 and 3n models in improving safety, while keeping unjustified refusals low. All testing was conducted without safety filters to evaluate the model capabilities and behaviors. For both text-to-text and image-to-text, and across all model sizes, the model produced minimal policy violations, and showed significant improvements over previous Gemma models' performance. 
+
+## **Usage and Limitations**
+
+These models have certain limitations that users should be aware of.
+
+### **Intended Usage**
+
+Multimodal models (capable of processing vision, language, and/or audio) 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**  
+  * **Text Generation**: These models can be used to generate creative text formats such as poems, scripts, code, marketing copy, and email drafts.  
+  * **Chatbots and Conversational AI**: Power conversational interfaces for customer service, virtual assistants, or interactive applications.  
+  * **Text Summarization**: Generate concise summaries of a text corpus, research papers, or reports.  
+  * **Image Data Extraction**: These models can be used to extract, interpret, and summarize visual data for text communications.  
+  * **Audio Processing and Interaction**: The E2B, E4B, and 12B models can analyze and interpret audio inputs, enabling voice-driven interactions and transcriptions.  
+* **Research and Education**  
+  * **Natural Language Processing (NLP) and VLM Research**: These models can serve as a foundation for researchers to experiment with VLM and NLP techniques, develop algorithms, and contribute to the advancement of the field.  
+  * **Language Learning Tools**: Support interactive language learning experiences, aiding in grammar correction or providing writing practice.  
+  * **Knowledge Exploration**: Assist researchers in exploring large bodies of text by generating summaries or answering questions about specific topics.
+
+### **Limitations**
+
+* **Training Data**  
+  * The quality and diversity of the training data significantly influence the model's capabilities. Biases or gaps in the training data can lead to limitations in the model's responses.  
+  * The scope of the training dataset determines the subject areas the model can handle effectively.  
+* **Context and Task Complexity**  
+  * Models perform well on tasks that can be framed with clear prompts and instructions. Open-ended or highly complex tasks might be challenging.  
+  * A model's performance can be influenced by the amount of context provided (longer context generally leads to better outputs, up to a certain point).  
+* **Language Ambiguity and Nuance**  
+  * Natural language is inherently complex. Models might struggle to grasp subtle nuances, sarcasm, or figurative language.  
+* **Factual Accuracy**  
+  * Models generate responses based on information they learned from their training datasets, but they are not knowledge bases. They may generate incorrect or outdated factual statements.  
+* **Common Sense**  
+  * Models rely on statistical patterns in language. They might lack the ability to apply common sense reasoning in certain situations.
+
+### **Ethical Considerations and Risks**
+
+The development of vision-language models (VLMs) raises several ethical concerns. In creating an open model, we have carefully considered the following:
+
+* **Bias and Fairness**  
+  * VLMs trained on large-scale, real-world text and image data can reflect socio-cultural biases embedded in the training material. Gemma 4 models underwent careful scrutiny, input data pre-processing, and post-training evaluations as reported in this card to help mitigate the risk of these biases.  
+* **Misinformation and Misuse**  
+  * VLMs can be misused to generate text that is false, misleading, or harmful.  
+  * Guidelines are provided for responsible use with the model, see the [Responsible Generative AI Toolkit](https://ai.google.dev/responsible).  
+* **Transparency and Accountability**  
+  * This model card summarizes details on the models' architecture, capabilities, limitations, and evaluation processes.  
+  * A responsibly developed open model offers the opportunity to share innovation by making VLM technology accessible to developers and researchers across the AI ecosystem.
+
+**Risks identified and mitigations**:
+
+* **Generation of harmful content**: Mechanisms and guidelines for content safety are essential. Developers are encouraged to exercise caution and implement appropriate content safety safeguards based on their specific product policies and application use cases.  
+* **Misuse for malicious purposes**: Technical limitations and developer and end-user education can help mitigate against malicious applications of VLMs. Educational resources and reporting mechanisms for users to flag misuse are provided.   
+* **Privacy violations**: Models were trained on data filtered for removal of certain personal information and other sensitive data. Developers are encouraged to adhere to privacy regulations with privacy-preserving techniques.  
+* **Perpetuation of biases**: It's encouraged to perform continuous monitoring (using evaluation metrics, human review) and the exploration of de-biasing techniques during model training, fine-tuning, and other use cases.
+
+### **Benefits**
+
+At the time of release, this family of models provides high-performance open vision-language model implementations designed from the ground up for responsible AI development compared to similarly sized models.
+
+## **Citation**
+
+If you find our work helpful, please consider citing it:
+
+```bibtex
+@misc{gemmateam2026gemma4,
+      title={Gemma 4 Technical Report}, 
+      author={Gemma Team},
+      year={2026},
+      eprint={2607.02770},
+      archivePrefix={arXiv},
+      primaryClass={cs.CL},
+      url={https://arxiv.org/abs/2607.02770}, 
+}
+```

docs/assistants/provenance.json

@@ -0,0 +1,54 @@
+{
+  "schema_version": 1,
+  "upstream": {
+    "repository": "google/gemma-4-E4B-it-assistant",
+    "revision": "8d0031ea8c2109e2b1e86bb9368a4539b537f80a",
+    "license": "Apache-2.0",
+    "license_source": "https://ai.google.dev/gemma/apache_2",
+    "gated": false,
+    "files": [
+      {
+        "file": "config.json",
+        "bytes": 2315,
+        "sha256": "13cdf5418e5a89cf951717a953cd11cef4e5c2743c4767e9e5dd72802954f822",
+        "url": "https://huggingface.co/google/gemma-4-E4B-it-assistant/resolve/8d0031ea8c2109e2b1e86bb9368a4539b537f80a/config.json"
+      },
+      {
+        "file": "generation_config.json",
+        "bytes": 307,
+        "sha256": "8e58004dc0e2407b63410b190bb8470efbdcfeb71533f1770e09c20abe193a6f",
+        "url": "https://huggingface.co/google/gemma-4-E4B-it-assistant/resolve/8d0031ea8c2109e2b1e86bb9368a4539b537f80a/generation_config.json"
+      },
+      {
+        "file": "tokenizer_config.json",
+        "bytes": 822,
+        "sha256": "089594a3924fcfd4cb1c596a7906fbf476193519e5198f780912eed02b177e42",
+        "url": "https://huggingface.co/google/gemma-4-E4B-it-assistant/resolve/8d0031ea8c2109e2b1e86bb9368a4539b537f80a/tokenizer_config.json"
+      },
+      {
+        "file": "tokenizer.json",
+        "bytes": 32169440,
+        "sha256": "75a6583c1a418e2bbd79c60d95d28e0f5bf549ad3f2990b5bdb5238c6c2bf70c",
+        "url": "https://huggingface.co/google/gemma-4-E4B-it-assistant/resolve/8d0031ea8c2109e2b1e86bb9368a4539b537f80a/tokenizer.json"
+      },
+      {
+        "file": "model.safetensors",
+        "bytes": 159138208,
+        "sha256": "12875062fc25c51e8fa9b62abd2de7ad48b7d63f8559d5d604fbd5a3d6bcff16",
+        "url": "https://huggingface.co/google/gemma-4-E4B-it-assistant/resolve/8d0031ea8c2109e2b1e86bb9368a4539b537f80a/model.safetensors"
+      }
+    ]
+  },
+  "conversion": {
+    "output_file": "Gemma-4-E4B-IT-Assistant-BF16.gguf",
+    "bytes": 171766688,
+    "sha256": "4e3c9d335b248ced9bd3e0584547efca30dbf6cfd0debb810613f811a575162a",
+    "CPU_only": true,
+    "output_type": "BF16 GGUF",
+    "converter_repository": "https://github.com/ggml-org/llama.cpp",
+    "converter_revision": "911f6cdc8ab8a530b2bee09ee61471a6f3178eeb",
+    "converter_sha256": "e9a1da876330bbce9687541ab31736542a01b4ac43c6686126514a50f122fb7f",
+    "gemma_converter_sha256": "872f3fea7496cefdcd39308ad02e2d30c9f507f68a18f8b4f6962995b09350f5",
+    "changed": "Serialization format only; no training."
+  }
+}

gguf/Gemma-4-E4B-IT-Assistant-BF16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4e3c9d335b248ced9bd3e0584547efca30dbf6cfd0debb810613f811a575162a
+size 171766688

release-manifest.json

@@ -4,7 +4,6 @@
   "base_model": "google/gemma-4-E4B-it",
   "base_revision": "ee0ef6023621cff504d758262d4e04895a5af4a2",
   "license": "apache-2.0",
-  "selected_checkpoint": "targeted:438",
   "training_method": "rank-32 alpha-64 LoRA on language tensors; FP32 adapter merge",
   "converter_revision": "911f6cdc8ab8a530b2bee09ee61471a6f3178eeb",
   "inference_source_commit": "77d1458",
@@ -23,6 +22,15 @@
       "path": "gguf/mmproj-Winnow-E4B.gguf",
       "bytes": 990372672,
       "sha256": "ddf46c21d7078e95338cfc22306b19b276a29a5ad089023449dd54d4b6170a51"
+    },
+    "mtp_assistant_bf16": {
+      "path": "gguf/Gemma-4-E4B-IT-Assistant-BF16.gguf",
+      "sha256": "4e3c9d335b248ced9bd3e0584547efca30dbf6cfd0debb810613f811a575162a",
+      "bytes": 171766688,
+      "source_model": "google/gemma-4-E4B-it-assistant",
+      "source_revision": "8d0031ea8c2109e2b1e86bb9368a4539b537f80a",
+      "license": "apache-2.0",
+      "documentation": "docs/assistants/README.md"
     }
   },
   "decision_calibration": {
@@ -67,5 +75,21 @@
     "kv_cache": "q8_0",
     "decision_parallel": 4,
     "scope": "synthetic-image operational smoke test; not broad vision or long-context quality"
+  },
+  "training_pipeline_released": false,
+  "optional_inference": {
+    "repository": "https://github.com/EldanRing/winnow-inference",
+    "runtime_lock_sha256": "9560b74c9fd736c80880c2733569075e066e7e8f49a7b465c8a4589604c4f65e",
+    "context": 8192,
+    "native_parallel": 4,
+    "chat_parallel": 1,
+    "cache": "q8_0",
+    "scope": "Linux/CUDA singleGPU tested RTX5070Ti16GB; experimental adaptive calibration text only",
+    "supported_presets": [
+      "e4b-q8-vision8k-mtp"
+    ],
+    "adaptive_policies": [
+      "e4b-calibrated50-v1"
+    ]
   }
 }