Upload BidirLM-270M-Embedding

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+final_results.png filter=lfs diff=lfs merge=lfs -text
+tokenizer.json filter=lfs diff=lfs merge=lfs -text

1_Pooling/config.json

@@ -0,0 +1,10 @@
+{
+    "word_embedding_dimension": 640,
+    "pooling_mode_cls_token": false,
+    "pooling_mode_mean_tokens": true,
+    "pooling_mode_max_tokens": false,
+    "pooling_mode_mean_sqrt_len_tokens": false,
+    "pooling_mode_weightedmean_tokens": false,
+    "pooling_mode_lasttoken": false,
+    "include_prompt": true
+}

README.md

@@ -0,0 +1,229 @@
+---
+tags:
+  - mteb
+  - sentence-transformers
+  - transformers
+  - embedding
+  - bidirectional
+  - multilingual
+pipeline_tag: sentence-similarity
+license: apache-2.0
+base_model: BidirLM/BidirLM-270M-Base
+language:
+  - multilingual
+  - af
+  - am
+  - ar
+  - az
+  - be
+  - bg
+  - bn
+  - bs
+  - ca
+  - ceb
+  - cs
+  - cy
+  - da
+  - de
+  - el
+  - en
+  - es
+  - et
+  - eu
+  - fa
+  - fi
+  - fr
+  - ga
+  - gl
+  - gu
+  - ha
+  - he
+  - hi
+  - hr
+  - ht
+  - hu
+  - hy
+  - id
+  - ig
+  - is
+  - it
+  - ja
+  - jv
+  - ka
+  - kk
+  - kn
+  - ko
+  - ky
+  - lt
+  - lv
+  - mg
+  - mk
+  - ml
+  - mr
+  - ms
+  - mt
+  - my
+  - nb
+  - ne
+  - nl
+  - nso
+  - ny
+  - pa
+  - pl
+  - ps
+  - pt
+  - ro
+  - ru
+  - sd
+  - si
+  - sk
+  - sl
+  - sn
+  - so
+  - sq
+  - sr
+  - su
+  - sv
+  - sw
+  - ta
+  - te
+  - th
+  - tl
+  - tr
+  - uk
+  - ur
+  - vi
+  - wo
+  - xh
+  - yo
+  - zh
+  - zu
+---
+
+# BidirLM-270M
+
+BidirLM is a family of 5 frontier bidirectional encoders, including an omnimodal variant at 2.5B, adapted from causal decoder LLMs. Contrary to contrastive-only models, BidirLM relies on a prior masking phase (MNTP) that enables state-of-the-art results on task-specific fine-tuning (NER, classification, NLI) while achieving frontier performance on embedding benchmarks (MTEB) against open-source alternatives.
+
+![Multilingual model performance by size on XTREME-Benchmark Augmented and MTEB Multilingual V2](final_results.png)
+
+| Model | Base LLM | Parameters | Embedding Dim | Max Tokens | MTEB Multi. V2 (Mean Task) |
+|---|---|---|---|---|---|
+| **BidirLM-270M** | **Gemma3-270M** | **268M** | **640** | **512** (\*) | **55.5** |
+| BidirLM-0.6B | Qwen3-0.6B | 596M | 1024 | 512 | 59.6 |
+| BidirLM-1B | Gemma3-1B | 1001M | 1152 | 512 | 62.1 |
+| BidirLM-1.7B | Qwen3-1.7B | 1721M | 2048 | 512 | 62.9 |
+| BidirLM-Omni-2.5B | Qwen3-1.7B | 2.5B | 2048 | 512 | 63.1 |
+
+(\*) While evaluated on MTEB with a max length of 512, the underlying architecture supports up to 32,768 context length (Gemma3). Longer sequences can be used by adjusting `model.max_seq_length` in Sentence Transformers or `max_length` in the tokenizer.
+
+## Supported Tasks
+
+**General embeddings** (via Sentence Transformers): retrieval, semantic similarity (STS), clustering, classification, pair classification, reranking, bitext mining, multilabel classification
+
+**Downstream fine-tuning** (via Transformers): sequence classification (e.g. MNLI, XNLI, PAWS-X, MathShepherd), token classification (e.g. PAN-X, POS), information retrieval (e.g. MIRACL, CodeSearchNet), sequence regression (e.g. Seahorse)
+
+## Usage
+
+### Sentence Transformers
+
+Use Sentence Transformers to compute embeddings for any text representation task.
+
+```python
+from sentence_transformers import SentenceTransformer
+
+model = SentenceTransformer("BidirLM/BidirLM-270M", trust_remote_code=True)
+
+queries = [
+    "What is the capital of France?",
+    "How does photosynthesis work?",
+]
+documents = [
+    "Paris is the capital and largest city of France, situated on the river Seine.",
+    "Photosynthesis is the process by which plants convert sunlight, water, and CO2 into glucose and oxygen.",
+]
+
+query_embeddings = model.encode(queries)
+document_embeddings = model.encode(documents)
+
+similarities = model.similarity(query_embeddings, document_embeddings)
+print(similarities)
+```
+
+### Fine-tuning for Downstream Tasks
+
+BidirLM can be directly fine-tuned for downstream tasks:
+
+```python
+from transformers import AutoTokenizer, AutoModelForSequenceClassification, AutoModelForTokenClassification
+
+tokenizer = AutoTokenizer.from_pretrained("BidirLM/BidirLM-270M", trust_remote_code=True)
+
+# Sequence classification (e.g., NLI: entailment, neutral, contradiction)
+seq_model = AutoModelForSequenceClassification.from_pretrained(
+    "BidirLM/BidirLM-270M",
+    trust_remote_code=True,
+    num_labels=3,
+)
+
+# Token classification (e.g., NER)
+tok_model = AutoModelForTokenClassification.from_pretrained(
+    "BidirLM/BidirLM-270M",
+    trust_remote_code=True,
+    num_labels=7,
+)
+
+# Fine-tune with HuggingFace Trainer
+```
+
+## Evaluation
+
+Please follow the [mteb repository](https://github.com/embeddings-benchmark/mteb) on how to reproduce our scores. The evaluation prompts used for each task are also available at [mteb_v2_eval_prompts.json](mteb_v2_eval_prompts.json).
+
+## Supported Languages
+
+Multilingual support across over 140 languages, inherited from the Gemma3 base model and reinforced through contrastive training with 87 languages.
+
+## Requirements
+
+This model requires `trust_remote_code=True` as it uses a custom bidirectional architecture.
+
+```
+transformers>=4.57.6,<5.0.0
+sentence-transformers>=5.0.0
+```
+
+## FAQ
+
+### 1. What pooling strategy does this model use?
+
+The model uses **mean pooling**. This is handled automatically when using Sentence Transformers.
+
+### 2. Do I need `trust_remote_code=True`?
+
+Yes. BidirLM uses a custom bidirectional architecture (`BidirLMModel`) that requires loading custom code from the repository.
+
+### 3. Why are my reproduced results slightly different from those reported in the model card?
+
+Different versions of `transformers` and `pytorch` could cause negligible but non-zero performance differences. This model was trained and evaluated with `transformers==4.57.6` and `pytorch==2.6.0`.
+
+### 4. What is the relationship between BidirLM-270M and BidirLM-270M-Base?
+
+[BidirLM/BidirLM-270M-Base](https://huggingface.co/BidirLM/BidirLM-270M-Base) is the intermediate MNTP-adapted checkpoint (bidirectional pretraining stage). BidirLM-270M is the final contrastive fine-tuned version optimized for both sentence embeddings and downstream fine-tuning.
+
+### 5. How is BidirLM different from other embedding models?
+
+Most embedding models (BGE-M3, KaLM, EmbedGemma, Qwen3-Embedding) use contrastive-only training, which optimizes embeddings but sacrifices fine-tuning ability. BidirLM restores a prior MNTP phase, advancing the Pareto frontier on both MTEB and XTREME simultaneously.
+
+## Citation
+
+```bibtex
+@misc{boizard2026bidirlmtextomnimodalbidirectional,
+      title={BidirLM: From Text to Omnimodal Bidirectional Encoders by Adapting and Composing Causal LLMs}, 
+      author={Nicolas Boizard and Théo Deschamps-Berger and Hippolyte Gisserot-Boukhlef and Céline Hudelot and Pierre Colombo},
+      year={2026},
+      eprint={2604.02045},
+      archivePrefix={arXiv},
+      primaryClass={cs.CL},
+      url={https://arxiv.org/abs/2604.02045}, 
+}
+```

added_tokens.json

@@ -0,0 +1,4 @@
+{
+  "<image_soft_token>": 262144,
+  "<|mask|>": 262145
+}

config.json

@@ -0,0 +1,63 @@
+{
+  "_sliding_window_pattern": 6,
+  "architectures": [
+    "BidirLMModel"
+  ],
+  "attention_bias": false,
+  "attention_dropout": 0.0,
+  "attn_logit_softcapping": null,
+  "auto_map": {
+    "AutoConfig": "configuration_bidirlm.BidirLMConfig",
+    "AutoModel": "modeling_bidirlm.BidirLMModel",
+    "AutoModelForMaskedLM": "modeling_bidirlm.BidirLMForMaskedLM",
+    "AutoModelForPreTraining": "modeling_bidirlm.BidirLMPreTrainedModel",
+    "AutoModelForSequenceClassification": "modeling_bidirlm.BidirLMForSequenceClassification",
+    "AutoModelForTokenClassification": "modeling_bidirlm.BidirLMForTokenClassification"
+  },
+  "bos_token_id": 2,
+  "classifier_pooling": "late",
+  "dtype": "bfloat16",
+  "eos_token_id": 1,
+  "final_logit_softcapping": null,
+  "head_dim": 256,
+  "hidden_activation": "gelu_pytorch_tanh",
+  "hidden_size": 640,
+  "initializer_range": 0.02,
+  "intermediate_size": 2048,
+  "layer_types": [
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "full_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "full_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "sliding_attention",
+    "full_attention"
+  ],
+  "max_position_embeddings": 32768,
+  "model_type": "bidirlm",
+  "num_attention_heads": 4,
+  "num_hidden_layers": 18,
+  "num_key_value_heads": 1,
+  "pad_token_id": 1,
+  "query_pre_attn_scalar": 256,
+  "rms_norm_eps": 1e-06,
+  "rope_local_base_freq": 10000.0,
+  "rope_scaling": null,
+  "rope_theta": 1000000.0,
+  "sliding_window": 256,
+  "transformers_version": "4.57.6",
+  "use_bidirectional_attention": true,
+  "use_cache": true,
+  "vocab_size": 262144
+}

config_sentence_transformers.json

@@ -0,0 +1,14 @@
+{
+  "model_type": "SentenceTransformer",
+  "__version__": {
+    "sentence_transformers": "5.2.3",
+    "transformers": "4.57.6",
+    "pytorch": "2.6.0"
+  },
+  "prompts": {
+    "query": "",
+    "document": ""
+  },
+  "default_prompt_name": null,
+  "similarity_fn_name": "cosine"
+}

configuration_bidirlm.py

@@ -0,0 +1,350 @@
+#                🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
+#           This file was automatically generated from src/transformers/models/gemma3/modular_gemma3.py.
+#               Do NOT edit this file manually as any edits will be overwritten by the generation of
+#             the file from the modular. If any change should be done, please apply the change to the
+#                          modular_gemma3.py file directly. One of our CI enforces this.
+#                🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
+# coding=utf-8
+# Copyright 2025 Google Inc. HuggingFace Inc. team. All rights reserved.
+#
+#
+# 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.
+from typing import Any, Optional, Union
+
+import transformers
+_v = transformers.__version__
+if _v < "4.57.6" or _v >= "5.0.0":
+    raise ImportError(
+        f"BidirLM requires transformers>=4.57.6,<5.0.0 (found {_v}). "
+        f"Install a compatible version: pip install 'transformers>=4.57.6,<5.0.0'"
+    )
+
+from transformers.configuration_utils import PretrainedConfig, layer_type_validation
+from transformers.modeling_rope_utils import rope_config_validation
+from transformers.utils import logging
+from transformers.models.siglip import SiglipVisionConfig
+
+
+logger = logging.get_logger(__name__)
+
+
+class BidirLMConfig(PretrainedConfig):
+    r"""
+    This is the configuration class to store the configuration of a [`BidirLMModel`]. It is used to instantiate an Gemma3Text
+    model according to the specified arguments, defining the model architecture. Instantiating a configuration with the
+    defaults will yield a similar configuration to that of the Gemma3Text-7B.
+    e.g. [google/gemma3_text-7b](https://huggingface.co/google/gemma3_text-7b)
+    Configuration objects inherit from [`PretrainedConfig`] and can be used to control the model outputs. Read the
+    documentation from [`PretrainedConfig`] for more information.
+    Args:
+        vocab_size (`int`, *optional*, defaults to 262208):
+            Vocabulary size of the Gemma3Text model. Defines the number of different tokens that can be represented by the
+            `inputs_ids` passed when calling [`BidirLMModel`]
+        hidden_size (`int`, *optional*, defaults to 2304):
+            Dimension of the hidden representations.
+        intermediate_size (`int`, *optional*, defaults to 9216):
+            Dimension of the MLP representations.
+        num_hidden_layers (`int`, *optional*, defaults to 26):
+            Number of hidden layers in the Transformer decoder.
+        num_attention_heads (`int`, *optional*, defaults to 8):
+            Number of attention heads for each attention layer in the Transformer decoder.
+        num_key_value_heads (`int`, *optional*, defaults to 4):
+            This is the number of key_value heads that should be used to implement Grouped Query Attention. If
+            `num_key_value_heads=num_attention_heads`, the model will use Multi Head Attention (MHA), if
+            `num_key_value_heads=1` the model will use Multi Query Attention (MQA) otherwise GQA is used. When
+            converting a multi-head checkpoint to a GQA checkpoint, each group key and value head should be constructed
+            by meanpooling all the original heads within that group. For more details, check out [this
+            paper](https://huggingface.co/papers/2305.13245). If it is not specified, will default to
+            `num_attention_heads`.
+        head_dim (`int`, *optional*, defaults to 256):
+            The attention head dimension.
+        hidden_activation (`str` or `function`, *optional*, defaults to `"gelu_pytorch_tanh"`):
+            The non-linear activation function (function or string) in the decoder. Will default to `"gelu_pytorch_tanh"`
+            if not specified. `"gelu_pytorch_tanh"` uses an approximation of the `"gelu"` activation function.
+        max_position_embeddings (`int`, *optional*, defaults to 131072):
+            The maximum sequence length that this model might ever be used with.
+        initializer_range (`float`, *optional*, defaults to 0.02):
+            The standard deviation of the truncated_normal_initializer for initializing all weight matrices.
+        rms_norm_eps (`float`, *optional*, defaults to 1e-06):
+            The epsilon used by the rms normalization layers.
+        use_cache (`bool`, *optional*, defaults to `True`):
+            Whether or not the model should return the last key/values attentions (not used by all models). Only
+            relevant if `config.is_decoder=True`.
+        pad_token_id (`int`, *optional*, defaults to 0):
+            Padding token id.
+        eos_token_id (`int`, *optional*, defaults to 1):
+            End of stream token id.
+        bos_token_id (`int`, *optional*, defaults to 2):
+            Beginning of stream token id.
+        tie_word_embeddings (`bool`, *optional*, defaults to `True`):
+            Whether to tie weight embeddings
+        rope_theta (`float`, *optional*, defaults to 1000000.0):
+            The base period of the RoPE embeddings.
+        attention_bias (`bool`, defaults to `False`, *optional*, defaults to `False`):
+            Whether to use a bias in the query, key, value and output projection layers during self-attention.
+        attention_dropout (`float`, *optional*, defaults to 0.0):
+            The dropout ratio for the attention probabilities.
+        query_pre_attn_scalar (`float`, *optional*, defaults to 256):
+            Scaling factor used on the attention scores
+        sliding_window (`int`, *optional*, defaults to 4096):
+            In Gemma3Text, every other layer uses sliding window attention. This is the size of the sliding window.
+        layer_types (`list`, *optional*):
+            Attention pattern for each layer.
+        final_logit_softcapping (`float`, *optional*):
+            Scaling factor when applying tanh softcapping on the logits.
+        attn_logit_softcapping (`float`, *optional*):
+            Scaling factor when applying tanh softcapping on the attention scores.
+        rope_scaling (`Dict`, *optional*):
+            Dictionary containing the scaling configuration for the RoPE embeddings used in global attention. NOTE: if you apply new rope type
+            and you expect the model to work on longer `max_position_embeddings`, we recommend you to update this value
+            accordingly.
+            Expected contents:
+                `rope_type` (`str`):
+                    The sub-variant of RoPE to use. Can be one of ['default', 'linear', 'dynamic', 'yarn', 'longrope',
+                    'llama3'], with 'default' being the original RoPE implementation.
+                `factor` (`float`, *optional*):
+                    Used with all rope types except 'default'. The scaling factor to apply to the RoPE embeddings. In
+                    most scaling types, a `factor` of x will enable the model to handle sequences of length x *
+                    original maximum pre-trained length.
+                `original_max_position_embeddings` (`int`, *optional*):
+                    Used with 'dynamic', 'longrope' and 'llama3'. The original max position embeddings used during
+                    pretraining.
+                `attention_factor` (`float`, *optional*):
+                    Used with 'yarn' and 'longrope'. The scaling factor to be applied on the attention
+                    computation. If unspecified, it defaults to value recommended by the implementation, using the
+                    `factor` field to infer the suggested value.
+                `beta_fast` (`float`, *optional*):
+                    Only used with 'yarn'. Parameter to set the boundary for extrapolation (only) in the linear
+                    ramp function. If unspecified, it defaults to 32.
+                `beta_slow` (`float`, *optional*):
+                    Only used with 'yarn'. Parameter to set the boundary for interpolation (only) in the linear
+                    ramp function. If unspecified, it defaults to 1.
+                `short_factor` (`list[float]`, *optional*):
+                    Only used with 'longrope'. The scaling factor to be applied to short contexts (<
+                    `original_max_position_embeddings`). Must be a list of numbers with the same length as the hidden
+                    size divided by the number of attention heads divided by 2
+                `long_factor` (`list[float]`, *optional*):
+                    Only used with 'longrope'. The scaling factor to be applied to long contexts (<
+                    `original_max_position_embeddings`). Must be a list of numbers with the same length as the hidden
+                    size divided by the number of attention heads divided by 2
+                `low_freq_factor` (`float`, *optional*):
+                    Only used with 'llama3'. Scaling factor applied to low frequency components of the RoPE
+                `high_freq_factor` (`float`, *optional*):
+                    Only used with 'llama3'. Scaling factor applied to high frequency components of the RoPE
+        rope_local_base_freq (float, *optional*, defaults to 10000.0):
+            The base period of the RoPE embeddings for local attention.
+        use_bidirectional_attention (`bool`, *optional*, defaults to `False`): If True, the model will attend to all
+            text tokens instead of using a causal mask. This does not change behavior for vision tokens.
+
+    ```python
+    >>> from transformers import BidirLMModel, BidirLMConfig
+    >>> # Initializing a Gemma3Text gemma3_text-7b style configuration
+    >>> configuration = BidirLMConfig()
+    >>> # Initializing a model from the gemma3_text-7b style configuration
+    >>> model = BidirLMModel(configuration)
+    >>> # Accessing the model configuration
+    >>> configuration = model.config
+    ```
+    """
+
+    model_type = "bidirlm"
+    keys_to_ignore_at_inference = ["past_key_values"]
+    base_model_tp_plan = {
+        "layers.*.self_attn.q_proj": "colwise",
+        "layers.*.self_attn.k_proj": "colwise",
+        "layers.*.self_attn.v_proj": "colwise",
+        "layers.*.self_attn.o_proj": "rowwise",
+        "layers.*.mlp.gate_proj": "colwise",
+        "layers.*.mlp.up_proj": "colwise",
+        "layers.*.mlp.down_proj": "rowwise",
+    }
+    base_model_pp_plan = {
+        "embed_tokens": (["input_ids"], ["inputs_embeds"]),
+        "layers": (["hidden_states", "attention_mask"], ["hidden_states"]),
+        "norm": (["hidden_states"], ["hidden_states"]),
+    }
+
+    def __init__(
+        self,
+        vocab_size=262_208,
+        hidden_size=2304,
+        intermediate_size=9216,
+        num_hidden_layers=26,
+        num_attention_heads=8,
+        num_key_value_heads=4,
+        head_dim=256,
+        hidden_activation="gelu_pytorch_tanh",
+        max_position_embeddings=131_072,
+        initializer_range=0.02,
+        rms_norm_eps=1e-6,
+        use_cache=True,
+        pad_token_id=0,
+        eos_token_id=1,
+        bos_token_id=2,
+        tie_word_embeddings=True,
+        rope_theta=1_000_000.0,
+        attention_bias=False,
+        attention_dropout=0.0,
+        query_pre_attn_scalar=256,
+        sliding_window=4096,
+        layer_types=None,
+        final_logit_softcapping=None,
+        attn_logit_softcapping=None,
+        rope_scaling=None,
+        rope_local_base_freq=10_000.0,
+        use_bidirectional_attention=True,
+        classifier_pooling="late",
+        **kwargs,
+    ):
+        super().__init__(
+            pad_token_id=pad_token_id,
+            bos_token_id=bos_token_id,
+            eos_token_id=eos_token_id,
+            tie_word_embeddings=tie_word_embeddings,
+            **kwargs,
+        )
+        self.vocab_size = vocab_size
+        self.max_position_embeddings = max_position_embeddings
+        self.hidden_size = hidden_size
+        self.intermediate_size = intermediate_size
+        self.num_hidden_layers = num_hidden_layers
+        self.num_attention_heads = num_attention_heads
+        self.head_dim = head_dim
+        self.num_key_value_heads = num_key_value_heads
+        self.initializer_range = initializer_range
+        self.rms_norm_eps = rms_norm_eps
+        self.use_cache = use_cache
+        self.rope_theta = rope_theta
+        self.attention_bias = attention_bias
+        self.attention_dropout = attention_dropout
+        self.hidden_activation = hidden_activation
+        self.query_pre_attn_scalar = query_pre_attn_scalar
+        self.sliding_window = sliding_window
+        self.final_logit_softcapping = final_logit_softcapping
+        self.attn_logit_softcapping = attn_logit_softcapping
+        self.layer_types = layer_types
+        self.use_bidirectional_attention = use_bidirectional_attention
+        self.classifier_pooling = classifier_pooling
+        if use_bidirectional_attention:
+            self.sliding_window = self.sliding_window // 2
+
+        self.rope_local_base_freq = rope_local_base_freq
+        self.rope_scaling = rope_scaling
+        rope_config_validation(self)
+
+        # BC -> the pattern used to be a simple int, and it's still present in configs on the Hub
+        self._sliding_window_pattern = kwargs.get("sliding_window_pattern", 6)
+
+        if self.layer_types is None:
+            self.layer_types = [
+                "sliding_attention" if bool((i + 1) % self._sliding_window_pattern) else "full_attention"
+                for i in range(self.num_hidden_layers)
+            ]
+        layer_type_validation(self.layer_types, self.num_hidden_layers)
+
+
+class Gemma3Config(PretrainedConfig):
+    r"""
+    This is the configuration class to store the configuration of a [`Gemma3ForConditionalGeneration`]. It is used to instantiate an
+    Gemma3ForConditionalGeneration according to the specified arguments, defining the model architecture. Instantiating a configuration
+    with the defaults will yield a similar configuration to that of the PaliGemma-2B.
+
+    e.g. [google/gemma-3-4b](https://huggingface.co/google/gemma-3-4b)
+
+    Configuration objects inherit from [`PretrainedConfig`] and can be used to control the model outputs. Read the
+    documentation from [`PretrainedConfig`] for more information.
+
+    Args:
+        text_config (`Union[BidirLMConfig, dict]`, *optional*):
+            The config object of the text backbone.
+        vision_config (`Union[AutoConfig, dict]`,  *optional*):
+            Custom vision config or dict.
+        mm_tokens_per_image (`int`, *optional*, defaults to 256):
+            The number of tokens per image embedding.
+        boi_token_index (`int`, *optional*, defaults to 255999):
+            The begin-of-image token index to wrap the image prompt.
+        eoi_token_index (`int`, *optional*, defaults to 256000):
+            The end-of-image token index to wrap the image prompt.
+        image_token_index (`int`, *optional*, defaults to 262144):
+            The image token index to encode the image prompt.
+        initializer_range (`float`, *optional*, defaults to 0.02):
+            The standard deviation of the truncated_normal_initializer for initializing all weight matrices.
+
+
+    Example:
+
+    ```python
+    >>> from transformers import Gemma3ForConditionalGeneration, Gemma3Config, SiglipVisionConfig, BidirLMConfig
+
+    >>> # Initializing a Siglip-like vision config
+    >>> vision_config = SiglipVisionConfig()
+
+    >>> # Initializing a Gemma3 Text config
+    >>> text_config = BidirLMConfig()
+
+    >>> # Initializing a Gemma3 gemma-3-4b style configuration
+    >>> configuration = Gemma3Config(vision_config, text_config)
+
+    >>> # Initializing a model from the gemma-3-4b style configuration
+    >>> model = BidirLMConfig(configuration)
+
+    >>> # Accessing the model configuration
+    >>> configuration = model.config
+    ```"""
+
+    model_type = "bidirlm"
+    attribute_map = {
+        "image_token_id": "image_token_index",
+        "boi_token_id": "boi_token_index",
+        "eoi_token_id": "eoi_token_index",
+    }
+    sub_configs = {
+        "text_config": BidirLMConfig,
+        "vision_config": SiglipVisionConfig,
+    }
+
+    def __init__(
+        self,
+        text_config: Optional[Union[BidirLMConfig, dict[str, Any]]] = None,
+        vision_config: Optional[Union[SiglipVisionConfig, dict[str, Any]]] = None,
+        mm_tokens_per_image: int = 256,
+        boi_token_index: int = 255_999,
+        eoi_token_index: int = 256_000,
+        image_token_index: int = 262_144,
+        initializer_range: float = 0.02,
+        **kwargs,
+    ):
+        if text_config is None:
+            text_config = BidirLMConfig()
+            logger.info("text_config is None, using default BidirLMConfig text config.")
+        elif isinstance(text_config, dict):
+            text_config = BidirLMConfig(**text_config)
+
+        if isinstance(vision_config, dict):
+            vision_config = SiglipVisionConfig(**vision_config)
+        elif vision_config is None:
+            vision_config = SiglipVisionConfig()
+            logger.info("vision_config is None, using default SiglipVisionConfig vision config.")
+
+        self.text_config = text_config
+        self.vision_config = vision_config
+        self.mm_tokens_per_image = mm_tokens_per_image
+        self.boi_token_index = boi_token_index
+        self.eoi_token_index = eoi_token_index
+        self.image_token_index = image_token_index
+        self.initializer_range = initializer_range
+
+        super().__init__(**kwargs)
+
+
+__all__ = ["Gemma3Config", "BidirLMConfig"]

model.safetensors

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

modeling_bidirlm.py

@@ -0,0 +1,1142 @@
+import copy
+from typing import Optional
+
+import transformers
+_v = transformers.__version__
+if _v < "4.57.6" or _v >= "5.0.0":
+    raise ImportError(
+        f"BidirLM requires transformers>=4.57.6,<5.0.0 (found {_v}). "
+        f"Install a compatible version: pip install 'transformers>=4.57.6,<5.0.0'"
+    )
+
+import torch
+import torch.nn as nn
+from torch.nn import BCEWithLogitsLoss, CrossEntropyLoss, MSELoss
+from transformers.activations import ACT2FN
+from transformers.modeling_layers import GradientCheckpointingLayer
+from transformers.modeling_outputs import (
+    BaseModelOutput,
+    MaskedLMOutput,
+    SequenceClassifierOutput,
+    TokenClassifierOutput,
+)
+from transformers.modeling_rope_utils import ROPE_INIT_FUNCTIONS, dynamic_rope_update
+from transformers.modeling_utils import PreTrainedModel
+
+from .configuration_bidirlm import Gemma3Config, BidirLMConfig
+
+try:
+    import flash_attn
+
+    FLASH_ATTN_AVAILABLE = True
+except ImportError:
+    FLASH_ATTN_AVAILABLE = False
+
+
+def batch_input_to_cu_seqlens(x: torch.Tensor, attention_mask: torch.Tensor):
+    lengths = attention_mask.sum(dim=1)
+    max_seqlen = int(lengths.max().item())
+    cu_seqlens = torch.zeros(lengths.size(0) + 1, dtype=torch.int32, device=x.device)
+    cu_seqlens[1:] = torch.cumsum(lengths, dim=0)
+    x = x[attention_mask.bool()]
+    return x, cu_seqlens, max_seqlen
+
+
+def cu_seqlens_to_batch_input(
+    x: torch.Tensor, cu_seqlens: torch.Tensor, max_seqlen: int
+):
+    B = cu_seqlens.size(0) - 1
+    D = x.size(1)
+    idx = torch.arange(max_seqlen, device=x.device).expand(B, max_seqlen)
+    lens = (cu_seqlens[1:] - cu_seqlens[:-1]).unsqueeze(1)
+    mask = idx < lens
+    base = cu_seqlens[:-1].unsqueeze(1)
+    gather_idx = (idx + base) * mask
+    out = torch.zeros(B, max_seqlen, D, device=x.device, dtype=x.dtype)
+    out[mask] = x[gather_idx[mask]]
+    return out
+
+
+def cu_attention_weight_to_batch(hidden_states, cu_seqlens, max_seqlen):
+    H, T, _ = hidden_states.shape
+    device = hidden_states.device
+    cu_seqlens = cu_seqlens.to(device, dtype=torch.long)
+
+    B = cu_seqlens.numel() - 1
+    start = cu_seqlens[:-1]
+    end = cu_seqlens[1:]
+    L = end - start
+
+    p = torch.arange(max_seqlen, device=device)
+    valid = p.unsqueeze(0) < L.unsqueeze(1)
+
+    rel = p.unsqueeze(0)
+    abs_idx = start.unsqueeze(1) + rel
+    abs_idx = torch.where(valid, abs_idx, torch.zeros_like(abs_idx))
+
+    attn = hidden_states.unsqueeze(0).expand(B, -1, -1, -1)
+
+    row_index = abs_idx[:, None, :, None].expand(B, H, max_seqlen, T)
+    attn_rows = torch.gather(attn, dim=2, index=row_index)
+
+    col_index = abs_idx[:, None, None, :].expand(B, H, max_seqlen, max_seqlen)
+    attn_padded = torch.gather(attn_rows, dim=3, index=col_index)
+
+    mask = valid.to(attn_padded.dtype)
+    attn_padded = attn_padded * mask[:, None, :, None] * mask[:, None, None, :]
+
+    return attn_padded
+
+
+class Gemma3Attention(nn.Module):
+    """Multi-headed attention from 'Attention Is All You Need' paper"""
+
+    def __init__(self, config: BidirLMConfig, layer_idx: int):
+        super().__init__()
+        self.is_sliding = config.layer_types[layer_idx] == "sliding_attention"
+        self.config = config
+        self.layer_idx = layer_idx
+        self.head_dim = getattr(
+            config, "head_dim", config.hidden_size // config.num_attention_heads
+        )
+        self.num_key_value_groups = (
+            config.num_attention_heads // config.num_key_value_heads
+        )
+        self.scaling = config.query_pre_attn_scalar**-0.5
+        self.attention_dropout = self.config.attention_dropout
+
+        self.q_proj = nn.Linear(
+            config.hidden_size,
+            config.num_attention_heads * self.head_dim,
+            bias=config.attention_bias,
+        )
+        self.k_proj = nn.Linear(
+            config.hidden_size,
+            config.num_key_value_heads * self.head_dim,
+            bias=config.attention_bias,
+        )
+        self.v_proj = nn.Linear(
+            config.hidden_size,
+            config.num_key_value_heads * self.head_dim,
+            bias=config.attention_bias,
+        )
+        self.o_proj = nn.Linear(
+            config.num_attention_heads * self.head_dim,
+            config.hidden_size,
+            bias=config.attention_bias,
+        )
+        self.attn_logit_softcapping = self.config.attn_logit_softcapping
+        self.sliding_window = config.sliding_window if self.is_sliding else None
+
+        self.q_norm = Gemma3RMSNorm(dim=config.head_dim, eps=config.rms_norm_eps)
+        self.k_norm = Gemma3RMSNorm(dim=config.head_dim, eps=config.rms_norm_eps)
+
+    def forward(
+        self,
+        hidden_states,
+        position_embeddings,
+        attention_mask,
+        cu_seqlens: Optional[torch.Tensor],
+        max_seqlen: Optional[int],
+        window_size: Optional[tuple[int, int]] = None,
+    ) -> tuple[torch.Tensor, Optional[torch.Tensor], Optional[tuple[torch.Tensor]]]:
+        input_shape = hidden_states.shape[:-1]
+        hidden_shape = (*input_shape, -1, self.head_dim)
+
+        query_states = self.q_proj(hidden_states).view(hidden_shape).transpose(0, 1)
+        key_states = self.k_proj(hidden_states).view(hidden_shape).transpose(0, 1)
+        value_states = self.v_proj(hidden_states).view(hidden_shape).transpose(0, 1)
+
+        query_states = self.q_norm(query_states)
+        key_states = self.k_norm(key_states)
+
+        cos, sin = position_embeddings
+        query_states, key_states = apply_rotary_pos_emb(
+            query_states, key_states, cos, sin
+        )
+
+        key_states = repeat_kv(key_states, self.num_key_value_groups)
+        value_states = repeat_kv(value_states, self.num_key_value_groups)
+
+        if (
+            self.config._attn_implementation == "flash_attention_2"
+            and FLASH_ATTN_AVAILABLE
+        ):
+            attn_weights = None
+            attn_output = flash_attn.flash_attn_varlen_func(
+                query_states.transpose(0, 1),
+                key_states.transpose(0, 1),
+                value_states.transpose(0, 1),
+                cu_seqlens,
+                cu_seqlens,
+                max_seqlen_q=max_seqlen,
+                max_seqlen_k=max_seqlen,
+                dropout_p=self.attention_dropout if self.training else 0.0,
+                softmax_scale=self.scaling,
+                causal=not self.config.use_bidirectional_attention,
+                window_size=window_size,
+            )
+        else:
+            attn_output, attn_weights = sdpa_attention_forward(
+                query_states,
+                key_states,
+                value_states,
+                attention_mask=attention_mask,
+                scaling=self.scaling,
+                dropout=self.attention_dropout if self.training else 0.0,
+                softcap=self.attn_logit_softcapping,
+            )
+
+        attn_output = attn_output.reshape(*input_shape, -1).contiguous()
+        attn_output = self.o_proj(attn_output)
+        return attn_output, attn_weights
+
+
+def sdpa_attention_forward(
+    q,
+    k,
+    v,
+    attention_mask,
+    scaling,
+    dropout: float = 0.0,
+    softcap: Optional[float] = None,
+):
+    attn_weights = torch.matmul(q, k.transpose(1, 2)) * scaling
+
+    if softcap is not None:
+        attn_weights = attn_weights / softcap
+        attn_weights = torch.tanh(attn_weights)
+        attn_weights = attn_weights * softcap
+
+    attn_weights = attn_weights + attention_mask
+
+    attn_weights = nn.functional.softmax(attn_weights, dim=-1, dtype=torch.float32).to(
+        q.dtype
+    )
+    attn_weights = nn.functional.dropout(attn_weights, p=dropout)
+
+    attn_output = torch.matmul(attn_weights, v)
+    attn_output = attn_output.transpose(0, 1).contiguous()
+
+    return attn_output, attn_weights
+
+
+def create_packed_seqs_mask(
+    cu_seqlens: torch.Tensor,
+    causal: bool = True,
+    device: torch.device = torch.device("cpu"),
+    window_size: Optional[tuple[int, int]] = None,
+) -> torch.Tensor:
+    """
+    Builds a block-diagonal attention mask for packed sequences.
+    Returns shape [total_len, total_len] with 0.0 for attention and -inf for masked.
+    """
+    total_len = cu_seqlens[-1]
+    seq_lengths = (cu_seqlens[1:] - cu_seqlens[:-1]).to(device)
+    
+    seq_ids = torch.repeat_interleave(
+        torch.arange(len(seq_lengths), device=device),
+        seq_lengths
+    )
+    
+    mask = seq_ids.unsqueeze(0) == seq_ids.unsqueeze(1)
+
+    if causal:
+        mask &= torch.tril(torch.ones(total_len, total_len, device=device, dtype=torch.bool))
+
+    if window_size is not None:
+        left, right = window_size
+        start_indices = torch.repeat_interleave(cu_seqlens[:-1].to(device), seq_lengths)
+        relative_pos = torch.arange(total_len, device=device) - start_indices
+
+        distance = relative_pos.unsqueeze(0) - relative_pos.unsqueeze(1)
+
+        if left >= 0:
+            mask &= (distance >= -left)
+        if right >= 0:
+            mask &= (distance <= right)
+
+    attn_mask = torch.full((total_len, total_len), float('-inf'), device=device)
+    attn_mask.masked_fill_(mask, 0.0)
+    
+    return attn_mask
+
+
+class Gemma3EncoderLayer(GradientCheckpointingLayer):
+    def __init__(self, config: BidirLMConfig, layer_idx: int):
+        super().__init__()
+        self.config = config
+        self.hidden_size = config.hidden_size
+        self.layer_idx = layer_idx
+        self.attention_type = config.layer_types[layer_idx]
+        self.self_attn = Gemma3Attention(config=config, layer_idx=layer_idx)
+        self.mlp = Gemma3MLP(config)
+        self.input_layernorm = Gemma3RMSNorm(self.hidden_size, eps=config.rms_norm_eps)
+        self.post_attention_layernorm = Gemma3RMSNorm(
+            self.hidden_size, eps=config.rms_norm_eps
+        )
+        self.pre_feedforward_layernorm = Gemma3RMSNorm(
+            self.hidden_size, eps=config.rms_norm_eps
+        )
+        self.post_feedforward_layernorm = Gemma3RMSNorm(
+            self.hidden_size, eps=config.rms_norm_eps
+        )
+
+    def forward(
+        self,
+        hidden_states: torch.Tensor,
+        position_embeddings_global: torch.Tensor,
+        position_embeddings_local: torch.Tensor,
+        attention_mask: Optional[torch.Tensor] = None,
+        cu_seqlens: Optional[torch.Tensor] = None,
+        max_seqlen: Optional[int] = None,
+        window_size: Optional[tuple[int, int]] = None,
+        output_attentions: Optional[bool] = False,
+    ) -> tuple[
+        torch.FloatTensor, Optional[tuple[torch.FloatTensor, torch.FloatTensor]]
+    ]:
+        residual = hidden_states
+        hidden_states = self.input_layernorm(hidden_states)
+
+        if self.self_attn.is_sliding:
+            position_embeddings = position_embeddings_local
+        else:
+            position_embeddings = position_embeddings_global
+
+        hidden_states, self_attn_weights = self.self_attn(
+            hidden_states=hidden_states,
+            position_embeddings=position_embeddings,
+            attention_mask=attention_mask,
+            cu_seqlens=cu_seqlens,
+            max_seqlen=max_seqlen,
+            window_size=window_size,
+        )
+        hidden_states = self.post_attention_layernorm(hidden_states)
+        hidden_states = residual + hidden_states
+
+        residual = hidden_states
+        hidden_states = self.pre_feedforward_layernorm(hidden_states)
+        hidden_states = self.mlp(hidden_states)
+        hidden_states = self.post_feedforward_layernorm(hidden_states)
+        hidden_states = residual + hidden_states
+
+        outputs = (hidden_states,)
+        if output_attentions:
+            outputs += (self_attn_weights,)
+
+        return outputs
+
+
+class BidirLMPreTrainedModel(PreTrainedModel):
+    config: Gemma3Config
+    base_model_prefix = "model"
+    _supports_flash_attn = True
+
+    def _init_weights(self, module):
+        super()._init_weights(module)
+        # if isinstance(module, Gemma3MultiModalProjector):
+        #     module.mm_input_projection_weight.data.zero_()
+        # # We initialize with 0s to be 1 centered as the RMSNorm here does (1 + weight)
+        # elif "RMSNorm" in module.__class__.__name__:
+        #     module.weight.data.zero_()
+        if "RMSNorm" in module.__class__.__name__:
+            module.weight.data.zero_()
+
+
+class Gemma3TextScaledWordEmbedding(nn.Embedding):
+    """
+    This module overrides nn.Embeddings' forward by multiplying with embeddings scale.
+    """
+
+    def __init__(
+        self,
+        num_embeddings: int,
+        embedding_dim: int,
+        padding_idx: int,
+        embed_scale: float = 1.0,
+    ):
+        super().__init__(num_embeddings, embedding_dim, padding_idx)
+        self.register_buffer("embed_scale", torch.tensor(embed_scale), persistent=False)
+
+    def forward(self, input_ids: torch.Tensor):
+        return self.weight[input_ids, :] * self.embed_scale.to(self.weight.dtype)
+
+
+class Gemma3MLP(nn.Module):
+    def __init__(self, config: BidirLMConfig):
+        super().__init__()
+        self.config = config
+        self.hidden_size = config.hidden_size
+        self.intermediate_size = config.intermediate_size
+        self.gate_proj = nn.Linear(self.hidden_size, self.intermediate_size, bias=False)
+        self.up_proj = nn.Linear(self.hidden_size, self.intermediate_size, bias=False)
+        self.down_proj = nn.Linear(self.intermediate_size, self.hidden_size, bias=False)
+        self.act_fn = ACT2FN[config.hidden_activation]
+
+    def forward(self, x):
+        down_proj = self.down_proj(self.act_fn(self.gate_proj(x)) * self.up_proj(x))
+        return down_proj
+
+
+class Gemma3RMSNorm(nn.Module):
+    def __init__(self, dim: int, eps: float = 1e-6):
+        super().__init__()
+        self.eps = eps
+        self.weight = nn.Parameter(torch.zeros(dim))
+
+    def _norm(self, x):
+        return x * torch.rsqrt(x.pow(2).mean(-1, keepdim=True) + self.eps)
+
+    def forward(self, x):
+        output = self._norm(x.float())
+        # Llama does x.to(float16) * w whilst Gemma3 is (x * w).to(float16)
+        # See https://github.com/huggingface/transformers/pull/29402
+        output = output * (1.0 + self.weight.float())
+        return output.type_as(x)
+
+    def extra_repr(self):
+        return f"{tuple(self.weight.shape)}, eps={self.eps}"
+
+
+class Gemma3RotaryEmbedding(nn.Module):
+    def __init__(self, config: BidirLMConfig, device=None):
+        super().__init__()
+        if hasattr(config, "rope_scaling") and isinstance(config.rope_scaling, dict):
+            self.rope_type = config.rope_scaling.get(
+                "rope_type", config.rope_scaling.get("type")
+            )
+        else:
+            self.rope_type = "default"
+        self.max_seq_len_cached = config.max_position_embeddings
+        self.original_max_seq_len = config.max_position_embeddings
+
+        self.config = config
+        self.rope_init_fn = ROPE_INIT_FUNCTIONS[self.rope_type]
+
+        inv_freq, self.attention_scaling = self.rope_init_fn(self.config, device)
+        self.register_buffer("inv_freq", inv_freq, persistent=False)
+        self.original_inv_freq = self.inv_freq
+
+    @torch.no_grad()
+    @dynamic_rope_update
+    def forward(self, x, position_ids):
+        inv_freq_expanded = self.inv_freq[:, None].float().to(x.device)
+        position_ids_expanded = position_ids[None, :].float()
+
+        device_type = (
+            x.device.type
+            if isinstance(x.device.type, str) and x.device.type != "mps"
+            else "cpu"
+        )
+        with torch.autocast(device_type=device_type, enabled=False):
+            freqs = (
+                inv_freq_expanded.float() @ position_ids_expanded.float()
+            ).transpose(0, 1)
+            emb = torch.cat((freqs, freqs), dim=-1)
+            cos = emb.cos() * self.attention_scaling
+            sin = emb.sin() * self.attention_scaling
+
+        return cos.to(dtype=x.dtype), sin.to(dtype=x.dtype)
+
+
+def rotate_half(x):
+    """Rotates half the hidden dims of the input."""
+    x1 = x[..., : x.shape[-1] // 2]
+    x2 = x[..., x.shape[-1] // 2 :]
+    return torch.cat((-x2, x1), dim=-1)
+
+
+def apply_rotary_pos_emb(q, k, cos, sin, position_ids=None, unsqueeze_dim=0):
+    """Applies Rotary Position Embedding to the query and key tensors.
+
+    Args:
+        q (`torch.Tensor`): The query tensor.
+        k (`torch.Tensor`): The key tensor.
+        cos (`torch.Tensor`): The cosine part of the rotary embedding.
+        sin (`torch.Tensor`): The sine part of the rotary embedding.
+        position_ids (`torch.Tensor`, *optional*):
+            Deprecated and unused.
+        unsqueeze_dim (`int`, *optional*, defaults to 1):
+            The 'unsqueeze_dim' argument specifies the dimension along which to unsqueeze cos[position_ids] and
+            sin[position_ids] so that they can be properly broadcasted to the dimensions of q and k. For example, note
+            that cos[position_ids] and sin[position_ids] have the shape [batch_size, seq_len, head_dim]. Then, if q and
+            k have the shape [batch_size, heads, seq_len, head_dim], then setting unsqueeze_dim=1 makes
+            cos[position_ids] and sin[position_ids] broadcastable to the shapes of q and k. Similarly, if q and k have
+            the shape [batch_size, seq_len, heads, head_dim], then set unsqueeze_dim=2.
+    Returns:
+        `tuple(torch.Tensor)` comprising of the query and key tensors rotated using the Rotary Position Embedding.
+    """
+    cos = cos.unsqueeze(unsqueeze_dim)
+    sin = sin.unsqueeze(unsqueeze_dim)
+    q_embed = (q * cos) + (rotate_half(q) * sin)
+    k_embed = (k * cos) + (rotate_half(k) * sin)
+    return q_embed, k_embed
+
+
+def repeat_kv(hidden_states: torch.Tensor, n_rep: int) -> torch.Tensor:
+    """
+    This is the equivalent of torch.repeat_interleave(x, dim=1, repeats=n_rep). The hidden states go from (batch,
+    num_key_value_heads, seqlen, head_dim) to (batch, num_attention_heads, seqlen, head_dim)
+    """
+    num_key_value_heads, slen, head_dim = hidden_states.shape
+    if n_rep == 1:
+        return hidden_states
+    hidden_states = hidden_states[:, None, :, :].expand(
+        num_key_value_heads, n_rep, slen, head_dim
+    )
+    return hidden_states.reshape(num_key_value_heads * n_rep, slen, head_dim)
+
+
+class BidirLMModel(BidirLMPreTrainedModel):
+    config: BidirLMConfig
+
+    def __init__(self, config: BidirLMConfig):
+        super().__init__(config)
+        self.padding_idx = config.pad_token_id
+        self.vocab_size = config.vocab_size
+
+        self.embed_tokens = Gemma3TextScaledWordEmbedding(
+            config.vocab_size,
+            config.hidden_size,
+            self.padding_idx,
+            embed_scale=self.config.hidden_size**0.5,
+        )
+        self.layers = nn.ModuleList(
+            [
+                Gemma3EncoderLayer(config, layer_idx)
+                for layer_idx in range(config.num_hidden_layers)
+            ]
+        )
+        self.norm = Gemma3RMSNorm(config.hidden_size, eps=config.rms_norm_eps)
+        self.rotary_emb = Gemma3RotaryEmbedding(config=config)
+        self.gradient_checkpointing = False
+
+        config = copy.deepcopy(config)
+        config.rope_theta = config.rope_local_base_freq
+        config.rope_scaling = {"rope_type": "default"}
+        self.rotary_emb_local = Gemma3RotaryEmbedding(config=config)
+
+        self.post_init()
+
+    def forward(
+        self,
+        input_ids: torch.LongTensor,
+        attention_mask: Optional[torch.Tensor] = None,
+        *,
+        cu_seqlens: Optional[torch.Tensor] = None,
+        max_seqlen: Optional[int] = None,
+        output_attentions: Optional[bool] = None,
+        output_hidden_states: Optional[bool] = None,
+        return_dict: Optional[bool] = None,
+        **kwargs,
+    ) -> tuple[torch.Tensor] | BaseModelOutput:
+        output_attentions = (
+            output_attentions
+            if output_attentions is not None
+            else self.config.output_attentions
+        )
+        output_hidden_states = (
+            output_hidden_states
+            if output_hidden_states is not None
+            else self.config.output_hidden_states
+        )
+        return_dict = (
+            return_dict if return_dict is not None else self.config.use_return_dict
+        )
+        all_hidden_states = () if output_hidden_states else None
+        all_self_attns = () if output_attentions else None
+
+        # For MNTP XP
+        batch_size, seq_len = input_ids.size()
+        new_input_ids = torch.empty((batch_size, seq_len + 1), dtype=input_ids.dtype, device=input_ids.device)
+        new_input_ids[:, 0] = 2
+        new_input_ids[:, 1:] = input_ids
+
+        if attention_mask is not None:
+            new_attention_mask = torch.empty((batch_size, seq_len + 1), dtype=attention_mask.dtype, device=attention_mask.device)
+            new_attention_mask[:, 0] = 1
+            new_attention_mask[:, 1:] = attention_mask
+            attention_mask = new_attention_mask
+            input_ids, cu_seqlens, max_seqlen = batch_input_to_cu_seqlens(new_input_ids, attention_mask)
+        else:
+            input_ids = new_input_ids
+            
+        if cu_seqlens is None or max_seqlen is None:
+            cu_seqlens = torch.tensor(
+                [0, input_ids.size(0)], dtype=torch.int32, device=input_ids.device
+            )
+            max_seqlen = input_ids.size(0)
+
+        hidden_states = self.embed_tokens(input_ids)
+
+        position_ids = torch.arange(len(input_ids), device=hidden_states.device)
+        position_embeddings_global = self.rotary_emb(hidden_states, position_ids)
+        position_embeddings_local = self.rotary_emb_local(hidden_states, position_ids)
+
+        window_size = (
+            (
+                self.config.sliding_window,
+                self.config.sliding_window if self.config.use_bidirectional_attention else 0
+            )
+            if self.config.sliding_window is not None
+            else None
+        )
+        # Only create attention masks when NOT using flash attention
+        # Flash attention handles masking internally and doesn't need pre-computed masks
+        if self.config._attn_implementation == "flash_attention_2" and FLASH_ATTN_AVAILABLE:
+            mask_mapping = {
+                "full_attention": None,
+                "sliding_attention": None
+            }
+        else:
+            mask_mapping = {
+                "full_attention": create_packed_seqs_mask(cu_seqlens, causal=not self.config.use_bidirectional_attention, device=hidden_states.device),
+                "sliding_attention": create_packed_seqs_mask(cu_seqlens, causal=not self.config.use_bidirectional_attention, device=hidden_states.device, window_size=window_size)
+            }
+
+        for encoder_layer in self.layers[: self.config.num_hidden_layers]:
+            if output_hidden_states:
+                if attention_mask is not None:
+                    all_hidden_states += (
+                        cu_seqlens_to_batch_input(
+                            hidden_states, cu_seqlens, attention_mask.shape[-1]
+                        )[0],
+                    )
+                else:
+                    all_hidden_states += (hidden_states,)
+
+            layer_outputs = encoder_layer(
+                hidden_states,
+                position_embeddings_global=position_embeddings_global,
+                position_embeddings_local=position_embeddings_local,
+                attention_mask=mask_mapping[encoder_layer.attention_type],
+                cu_seqlens=cu_seqlens,
+                max_seqlen=max_seqlen,
+                window_size=window_size if encoder_layer.attention_type == "sliding_attention" else (-1, -1),
+            )
+
+            hidden_states = layer_outputs[0]
+            if output_attentions:
+                if attention_mask is not None:
+                    all_self_attns += (
+                        cu_attention_weight_to_batch(
+                            layer_outputs[1], cu_seqlens, attention_mask.shape[-1]
+                        ),
+                    )
+
+                else:
+                    all_self_attns += (layer_outputs[1],)
+
+        hidden_states = self.norm(hidden_states)
+        if attention_mask is not None:
+            hidden_states = cu_seqlens_to_batch_input(
+                hidden_states, cu_seqlens, attention_mask.shape[-1]
+            )
+        if output_hidden_states:
+            all_hidden_states += (hidden_states,)
+
+        # For MNTP XP
+        output = BaseModelOutput(
+            last_hidden_state=hidden_states[:, :-1, :],
+            hidden_states=tuple(h[:, :-1, :] for h in all_hidden_states) if all_hidden_states is not None else None,
+            attentions=tuple(a[:, :, :-1, :-1] for a in all_self_attns) if all_self_attns is not None else None,
+        )
+        return output if return_dict else output.to_tuple()
+
+
+class BidirLMForMaskedLM(BidirLMPreTrainedModel):
+    _tied_weights_keys = ["lm_head.weight"]
+    config: BidirLMConfig
+
+    def __init__(self, config):
+        super().__init__(config)
+        self.model = BidirLMModel(config)
+        self.vocab_size = config.vocab_size
+        self.lm_head = nn.Linear(config.hidden_size, config.vocab_size, bias=False)
+
+        self.post_init()
+
+    def forward(
+        self,
+        input_ids: torch.LongTensor,
+        *,
+        attention_mask: Optional[torch.Tensor] = None,
+        cu_seqlens: Optional[torch.Tensor] = None,
+        max_seqlen: Optional[int] = None,
+        labels: Optional[torch.LongTensor] = None,
+        output_attentions: Optional[bool] = None,
+        output_hidden_states: Optional[bool] = None,
+        return_dict: Optional[bool] = None,
+        **kwargs,
+    ) -> tuple[Optional[torch.Tensor], Optional[torch.Tensor]]:
+        return_dict = (
+            return_dict if return_dict is not None else self.config.use_return_dict
+        )
+        encoder_output = self.model(
+            input_ids=input_ids,
+            attention_mask=attention_mask,
+            cu_seqlens=cu_seqlens,
+            max_seqlen=max_seqlen,
+            output_attentions=output_attentions,
+            output_hidden_states=output_hidden_states,
+            return_dict=return_dict,
+        )
+
+        logits = self.lm_head(encoder_output[0])
+        if self.config.final_logit_softcapping is not None:
+            logits = logits / self.config.final_logit_softcapping
+            logits = torch.tanh(logits)
+            logits = logits * self.config.final_logit_softcapping
+
+        loss = None
+        if labels is not None:
+            loss = self.loss_function(logits, labels, vocab_size=self.config.vocab_size)
+
+        output = MaskedLMOutput(
+            loss=loss,
+            logits=logits,
+            hidden_states=encoder_output.hidden_states,
+            attentions=encoder_output.attentions,
+        )
+        return output if return_dict else output.to_tuple()
+
+
+class BidirLMForSequenceClassification(BidirLMPreTrainedModel):
+    config: BidirLMConfig
+
+    def __init__(self, config):
+        super().__init__(config)
+        self.num_labels = config.num_labels
+        self.classifier_pooling = config.classifier_pooling
+
+        self.model = BidirLMModel(config)
+        self.dense = nn.Linear(config.hidden_size, config.hidden_size)
+        self.activation = nn.GELU()
+        self.classifier = nn.Linear(config.hidden_size, self.num_labels)
+        self.post_init()
+
+    def forward(
+        self,
+        input_ids: Optional[torch.LongTensor] = None,
+        attention_mask: Optional[torch.Tensor] = None,
+        labels: Optional[torch.LongTensor] = None,
+        output_attentions: Optional[bool] = None,
+        output_hidden_states: Optional[bool] = None,
+        return_dict: Optional[bool] = None,
+        **kwargs,
+    ) -> tuple[torch.Tensor] | SequenceClassifierOutput:
+        return_dict = (
+            return_dict if return_dict is not None else self.config.use_return_dict
+        )
+
+        encoder_output = self.model(
+            input_ids,
+            attention_mask=attention_mask,
+            output_attentions=output_attentions,
+            output_hidden_states=output_hidden_states,
+            return_dict=return_dict,
+        )
+        last_hidden_state = encoder_output[0]
+
+        if self.classifier_pooling in ["bos", "mean"]:
+            if self.classifier_pooling == "bos":
+                pooled_output = last_hidden_state[:, 0]
+
+            elif self.classifier_pooling == "mean":
+                if attention_mask is None:
+                    pooled_output = last_hidden_state.mean(dim=1)
+                else:
+                    pooled_output = (
+                        last_hidden_state * attention_mask.unsqueeze(-1)
+                    ).sum(dim=1)
+                    pooled_output /= attention_mask.sum(dim=1, keepdim=True)
+
+            pooled_output = self.dense(pooled_output)
+            pooled_output = self.activation(pooled_output)
+            logits = self.classifier(pooled_output)
+        elif self.classifier_pooling == "late":
+            x = self.dense(last_hidden_state)
+            x = self.activation(x)
+            logits = self.classifier(x)
+            if attention_mask is None:
+                logits = logits.mean(dim=1)
+            else:
+                logits = (logits * attention_mask.unsqueeze(-1)).sum(dim=1)
+                logits /= attention_mask.sum(dim=1, keepdim=True)
+
+        loss = None
+        if labels is not None:
+            labels = labels.to(logits.device)
+            if self.config.problem_type is None:
+                if self.num_labels == 1:
+                    self.config.problem_type = "regression"
+                elif self.num_labels > 1 and (
+                    labels.dtype == torch.long or labels.dtype == torch.int
+                ):
+                    self.config.problem_type = "single_label_classification"
+                else:
+                    self.config.problem_type = "multi_label_classification"
+
+            if self.config.problem_type == "regression":
+                loss_fct = MSELoss()
+                if self.num_labels == 1:
+                    loss = loss_fct(logits.squeeze(), labels.squeeze())
+                else:
+                    loss = loss_fct(logits, labels)
+            elif self.config.problem_type == "single_label_classification":
+                loss_fct = CrossEntropyLoss()
+                loss = loss_fct(logits.view(-1, self.num_labels), labels.view(-1))
+            elif self.config.problem_type == "multi_label_classification":
+                loss_fct = BCEWithLogitsLoss()
+                loss = loss_fct(logits, labels)
+
+        output = SequenceClassifierOutput(
+            loss=loss,
+            logits=logits,
+            hidden_states=encoder_output.hidden_states,
+            attentions=encoder_output.attentions,
+        )
+        return output if return_dict else output.to_tuple()
+
+
+class BidirLMForTokenClassification(BidirLMPreTrainedModel):
+    config: BidirLMConfig
+    
+    def __init__(self, config):
+        super().__init__(config)
+        self.num_labels = config.num_labels
+
+        self.model = BidirLMModel(config)
+        self.classifier = nn.Linear(config.hidden_size, config.num_labels)
+        self.post_init()
+
+    def forward(
+        self,
+        input_ids: Optional[torch.LongTensor] = None,
+        attention_mask: Optional[torch.Tensor] = None,
+        position_ids: Optional[torch.LongTensor] = None,
+        inputs_embeds: Optional[torch.FloatTensor] = None,
+        labels: Optional[torch.LongTensor] = None,
+        use_cache: Optional[bool] = None,
+        output_attentions: Optional[bool] = None,
+        output_hidden_states: Optional[bool] = None,
+        return_dict: Optional[bool] = None,
+    ) -> tuple[torch.Tensor] | TokenClassifierOutput:
+        return_dict = (
+            return_dict if return_dict is not None else self.config.use_return_dict
+        )
+
+        outputs = self.model(
+            input_ids,
+            attention_mask=attention_mask,
+            position_ids=position_ids,
+            inputs_embeds=inputs_embeds,
+            use_cache=use_cache,
+            output_attentions=output_attentions,
+            output_hidden_states=output_hidden_states,
+            return_dict=return_dict,
+        )
+        sequence_output = outputs[0]
+        logits = self.classifier(sequence_output)
+
+        loss = None
+        if labels is not None:
+            loss_fct = CrossEntropyLoss()
+            loss = loss_fct(logits.view(-1, self.num_labels), labels.view(-1))
+
+        if not return_dict:
+            output = (logits,) + outputs[2:]
+            return ((loss,) + output) if loss is not None else output
+
+        return TokenClassifierOutput(
+            loss=loss,
+            logits=logits,
+            hidden_states=outputs.hidden_states,
+            attentions=outputs.attentions,
+        )
+
+
+# MultiModal
+# class Gemma3Model(BidirLMPreTrainedModel):
+#     _checkpoint_conversion_mapping = {"language_model.model": "language_model"}
+#     # we are filtering the logits/labels so we shouldn't divide the loss based on num_items_in_batch
+#     accepts_loss_kwargs = False
+
+#     def __init__(self, config: Gemma3Config):
+#         super().__init__(config)
+#         self.vision_tower = AutoModel.from_config(config=config.vision_config)
+#         self.multi_modal_projector = Gemma3MultiModalProjector(config)
+#         self.vocab_size = config.text_config.vocab_size
+
+#         language_model = AutoModel.from_config(config=config.text_config)
+#         self.language_model = language_model
+
+#         self.pad_token_id = self.config.pad_token_id if self.config.pad_token_id is not None else -1
+#         self.post_init()
+
+#     def get_input_embeddings(self):
+#         return self.language_model.get_input_embeddings()
+
+#     def set_input_embeddings(self, value):
+#         self.language_model.set_input_embeddings(value)
+
+#     def set_decoder(self, decoder):
+#         self.language_model = decoder
+
+#     def get_decoder(self):
+#         return self.language_model
+
+#     def get_image_features(self, pixel_values: torch.Tensor) -> torch.Tensor:
+#         """
+#         Projects the last hidden state from the vision model into language model space.
+
+#         Args:
+#             pixel_values (`torch.FloatTensor]` of shape `(batch_size, channels, height, width)`)
+#                The tensors corresponding to the input images.
+#         Returns:
+#             image_features (`torch.Tensor`): Image feature tensor of shape `(num_images, image_length, embed_dim)`).
+#         """
+#         vision_outputs = self.vision_tower(pixel_values=pixel_values).last_hidden_state
+#         image_features = self.multi_modal_projector(vision_outputs)
+#         return image_features
+
+#     def get_placeholder_mask(
+#         self, input_ids: torch.LongTensor, inputs_embeds: torch.FloatTensor, image_features: torch.FloatTensor
+#     ):
+#         """
+#         Obtains multimodal placeholder mask from `input_ids` or `inputs_embeds`, and checks that the placeholder token count is
+#         equal to the length of multimodal features. If the lengths are different, an error is raised.
+#         """
+#         if input_ids is None:
+#             special_image_mask = inputs_embeds == self.get_input_embeddings()(
+#                 torch.tensor(self.config.image_token_id, dtype=torch.long, device=inputs_embeds.device)
+#             )
+#             special_image_mask = special_image_mask.all(-1)
+#         else:
+#             special_image_mask = input_ids == self.config.image_token_id
+
+#         n_image_tokens = special_image_mask.sum()
+#         special_image_mask = special_image_mask.unsqueeze(-1).expand_as(inputs_embeds).to(inputs_embeds.device)
+#         n_image_features = image_features.shape[0] * image_features.shape[1]
+#         if inputs_embeds[special_image_mask].numel() != image_features.numel():
+#             raise ValueError(
+#                 f"Image features and image tokens do not match: tokens: {n_image_tokens}, features {n_image_features}"
+#             )
+#         return special_image_mask
+
+
+#     def forward(
+#         self,
+#         input_ids: Optional[torch.LongTensor] = None,
+#         pixel_values: Optional[torch.FloatTensor] = None,
+#         attention_mask: Optional[torch.Tensor] = None,
+#         position_ids: Optional[torch.LongTensor] = None,
+#         past_key_values: Optional[Cache] = None,
+#         token_type_ids: Optional[torch.LongTensor] = None,
+#         cache_position: Optional[torch.LongTensor] = None,
+#         inputs_embeds: Optional[torch.FloatTensor] = None,
+#         labels: Optional[torch.LongTensor] = None,
+#         use_cache: Optional[bool] = None,
+#         output_attentions: Optional[bool] = None,
+#         output_hidden_states: Optional[bool] = None,
+#         return_dict: Optional[bool] = None,
+#         **lm_kwargs,
+#     ) -> tuple:
+#         r"""
+#         labels (`torch.LongTensor` of shape `(batch_size, sequence_length)`, *optional*):
+#             Labels for computing the masked language modeling loss. Indices should either be in `[0, ...,
+#             config.text_config.vocab_size]` or -100 (see `input_ids` docstring). Tokens with indices set to `-100` are ignored
+#             (masked), the loss is only computed for the tokens with labels in `[0, ..., config.text_config.vocab_size]`.
+
+#         Example:
+
+#         ```python
+#         >>> from PIL import Image
+#         >>> import requests
+#         >>> from transformers import AutoProcessor, Gemma3ForConditionalGeneration
+
+#         >>> model = Gemma3ForConditionalGeneration.from_pretrained("google/gemma32-3b-mix-224")
+#         >>> processor = AutoProcessor.from_pretrained("google/gemma32-3b-mix-224")
+
+#         >>> prompt = "Where is the cat standing?"
+#         >>> url = "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/pipeline-cat-chonk.jpeg"
+#         >>> image = Image.open(requests.get(url, stream=True).raw)
+
+#         >>> inputs = processor(images=image, text=prompt,  return_tensors="pt")
+
+#         >>> # Generate
+#         >>> generate_ids = model.generate(**inputs,)
+#         >>> processor.batch_decode(generate_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False)[0]
+#         "Where is the cat standing?\nsnow"
+#         ```"""
+#         if (input_ids is None) ^ (inputs_embeds is not None):
+#             raise ValueError("You must specify exactly one of input_ids or inputs_embeds")
+
+#         output_attentions = output_attentions if output_attentions is not None else self.config.output_attentions
+#         output_hidden_states = (
+#             output_hidden_states if output_hidden_states is not None else self.config.output_hidden_states
+#         )
+#         return_dict = return_dict if return_dict is not None else self.config.use_return_dict
+
+#         # Replace image id with PAD if the image token if OOV, to avoid index-errors
+#         if input_ids is not None and self.config.image_token_id >= self.vocab_size:
+#             special_image_mask = input_ids == self.config.image_token_id
+#             llm_input_ids = input_ids.clone()
+#             llm_input_ids[special_image_mask] = 0
+#         else:
+#             llm_input_ids = input_ids
+
+#         if inputs_embeds is None:
+#             inputs_embeds = self.get_input_embeddings()(llm_input_ids)
+
+#         if cache_position is None:
+#             past_seen_tokens = past_key_values.get_seq_length() if past_key_values is not None else 0
+#             cache_position = torch.arange(
+#                 past_seen_tokens, past_seen_tokens + inputs_embeds.shape[1], device=inputs_embeds.device
+#             )
+
+#         # Merge text and images
+#         if pixel_values is not None:
+#             image_features = self.get_image_features(pixel_values)
+#             image_features = image_features.to(inputs_embeds.device, inputs_embeds.dtype)
+#             special_image_mask = self.get_placeholder_mask(
+#                 input_ids, inputs_embeds=inputs_embeds, image_features=image_features
+#             )
+#             inputs_embeds = inputs_embeds.masked_scatter(special_image_mask, image_features)
+
+#         # It may already have been prepared by e.g. `generate`
+#         if not isinstance(causal_mask_mapping := attention_mask, dict):
+#             # Prepare mask arguments
+#             mask_kwargs = {
+#                 "config": self.config.get_text_config(),
+#                 "input_embeds": inputs_embeds,
+#                 "attention_mask": attention_mask,
+#                 "cache_position": cache_position,
+#                 "past_key_values": past_key_values,
+#                 "position_ids": position_ids,
+#             }
+#             # NOTE: this `is_prefill` logic is not flawless, it fails when we're using a cache eagerly initialized
+#             # (e.g. compiled prefill) AND `pixel_values` are not provided. Determining prefill in that case requires
+#             # checking data values, which is not compile-compatible.
+#             is_prefill = (
+#                 not use_cache
+#                 or past_key_values is None
+#                 or not past_key_values.is_initialized
+#                 or pixel_values is not None
+#             )
+#             if token_type_ids is not None and is_prefill:
+#                 # We need to pass an additional mask function to account for token type ids, and it needs to be an `or`
+
+#                 # First find where a new image block starts: 1 if image and previous not image
+#                 # The images cannot attend to future images, but can attend to all prev images and to itself
+#                 # bidirectionally
+#                 is_image = (token_type_ids == 1).to(cache_position.device)
+#                 new_image_start = is_image & ~nn.functional.pad(is_image, (1, 0), value=0)[:, :-1]
+#                 image_group_ids = torch.cumsum(new_image_start.int(), dim=1) - 1
+#                 image_group_ids = torch.where(
+#                     is_image, image_group_ids, torch.full_like(token_type_ids, -1, device=is_image.device)
+#                 )
+#                 mask_kwargs["or_mask_function"] = token_type_ids_mask_function(
+#                     token_type_ids.to(cache_position.device), image_group_ids, self.config.mm_tokens_per_image
+#                 )
+
+#             # Create the masks
+#             causal_mask_mapping = {
+#                 "full_attention": create_causal_mask(**mask_kwargs),
+#                 "sliding_attention": create_sliding_window_causal_mask(**mask_kwargs),
+#             }
+
+#         outputs = self.language_model(
+#             attention_mask=causal_mask_mapping,
+#             position_ids=position_ids,
+#             past_key_values=past_key_values,
+#             inputs_embeds=inputs_embeds,
+#             use_cache=use_cache,
+#             output_attentions=output_attentions,
+#             output_hidden_states=output_hidden_states,
+#             return_dict=True,
+#             cache_position=cache_position,
+#             **lm_kwargs,
+#         )
+
+#         return (
+#             outputs,
+#             image_features if pixel_values is not None else None,
+#         )
+
+# class Gemma3MultiModalProjector(nn.Module):
+#     def __init__(self, config: Gemma3Config):
+#         super().__init__()
+
+#         self.mm_input_projection_weight = nn.Parameter(
+#             torch.zeros(config.vision_config.hidden_size, config.text_config.hidden_size)
+#         )
+
+#         self.mm_soft_emb_norm = Gemma3RMSNorm(
+#             config.vision_config.hidden_size, eps=config.vision_config.layer_norm_eps
+#         )
+
+#         self.patches_per_image = int(config.vision_config.image_size // config.vision_config.patch_size)
+#         self.tokens_per_side = int(config.mm_tokens_per_image**0.5)
+#         self.kernel_size = self.patches_per_image // self.tokens_per_side
+#         self.avg_pool = nn.AvgPool2d(kernel_size=self.kernel_size, stride=self.kernel_size)
+
+#     def forward(self, vision_outputs: torch.Tensor):
+#         batch_size, _, seq_length = vision_outputs.shape
+
+#         reshaped_vision_outputs = vision_outputs.transpose(1, 2)
+#         reshaped_vision_outputs = reshaped_vision_outputs.reshape(
+#             batch_size, seq_length, self.patches_per_image, self.patches_per_image
+#         )
+#         reshaped_vision_outputs = reshaped_vision_outputs.contiguous()
+
+#         pooled_vision_outputs = self.avg_pool(reshaped_vision_outputs)
+#         pooled_vision_outputs = pooled_vision_outputs.flatten(2)
+#         pooled_vision_outputs = pooled_vision_outputs.transpose(1, 2)
+
+#         normed_vision_outputs = self.mm_soft_emb_norm(pooled_vision_outputs)
+
+#         projected_vision_outputs = torch.matmul(normed_vision_outputs, self.mm_input_projection_weight)
+#         return projected_vision_outputs.type_as(vision_outputs)
+
+# def token_type_ids_mask_function(
+#     token_type_ids: Optional[torch.Tensor],
+#     image_group_ids: Optional[torch.Tensor],
+#     tokens_per_image: int,
+# ) -> Optional[Callable]:
+#     """
+#     This function adds the correct offsets to the `q_idx` and `kv_idx` as the torch API can only accept lengths,
+#     not start and end indices.
+#     """
+#     # Do not return an additional mask in this case
+#     if token_type_ids is None:
+#         return None
+
+#     def inner_mask(batch_idx: int, head_idx: int, q_idx: int, kv_idx: int) -> bool:
+#         # If it's 1 for both query and key/value, we are in an image block
+#         # NOTE: static cache shape goes beyond input seq length, while token_type_ids.shape[1] == input seq length
+#         # Since vmap doesn't support `if statement` we workaround it with `torch.where`
+#         safe_idx = torch.where(kv_idx < token_type_ids.shape[1], kv_idx, 0)
+#         token_type_ids_at_kv_idx = token_type_ids[batch_idx, safe_idx]
+#         token_type_ids_at_kv_idx = torch.where(kv_idx < token_type_ids.shape[1], token_type_ids_at_kv_idx, 0)
+
+#         image_group_ids_at_kv_idx = image_group_ids[batch_idx, safe_idx]
+#         image_group_ids_at_kv_idx = torch.where(kv_idx < image_group_ids.shape[1], image_group_ids_at_kv_idx, -1)
+
+#         is_image_block = (token_type_ids[batch_idx, q_idx] == 1) & (token_type_ids_at_kv_idx == 1)
+#         same_image_block = image_group_ids[batch_idx, q_idx] == image_group_ids_at_kv_idx
+
+#         # This is bidirectional attention whenever we are dealing with image tokens
+#         return is_image_block & same_image_block
+
+#     return inner_mask
+
+
+__all__ = [
+    "BidirLMPreTrainedModel",
+    "BidirLMModel",
+    "BidirLMForMaskedLM",
+    "BidirLMForSequenceClassification",
+    "BidirLMForTokenClassification",
+    # "Gemma3Model",
+]

modules.json

@@ -0,0 +1,14 @@
+[
+  {
+    "idx": 0,
+    "name": "0",
+    "path": "",
+    "type": "sentence_transformers.models.Transformer"
+  },
+  {
+    "idx": 1,
+    "name": "1",
+    "path": "1_Pooling",
+    "type": "sentence_transformers.models.Pooling"
+  }
+]

mteb_v2_eval_prompts.json

@@ -0,0 +1,262 @@
+{
+    "AmazonCounterfactualClassification": "Given an Amazon review, judge whether it is counterfactual.",
+    "AmazonPolarityClassification": "Classifying Amazon reviews into positive or negative sentiment",
+    "AmazonReviewsClassification": "Classifying the given Amazon review into its appropriate rating category",
+    "Banking77Classification": "Given an online banking query, find the corresponding intents",
+    "EmotionClassification": "Classify the emotion expressed in the given Twitter message into one of the six emotions: anger, fear, joy, love, sadness, and surprise",
+    "ImdbClassification": "Classifying the sentiment expressed in the given movie review text from the IMDB dataset",
+    "MassiveIntentClassification": "Given a user utterance as query, find the user intents",
+    "MassiveScenarioClassification": "Given a user utterance as query, find the user scenarios",
+    "MTOPDomainClassification": "Classifying the intent domain of the given utterance in task-oriented conversation",
+    "MTOPIntentClassification": "Classifying the intent of the given utterance in task-oriented conversation",
+    "ToxicConversationsClassification": "Classifying the given comments as either toxic or not toxic",
+    "TweetSentimentExtractionClassification": "Classifying the sentiment of a given tweet as either positive, negative, or neutral",
+    "TNews": "Categorizing the given news title",
+    "IFlyTek": "Given an App description text, find the appropriate fine-grained category",
+    "MultilingualSentiment": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "JDReview": "Classifying sentiment of the customer review for iPhoneinto positive or negative",
+    "OnlineShopping": "Classifying sentiment of the customer reviewinto positive or negative",
+    "Waimai": "Classify the customer review from a food takeaway platform into positive or negative",
+    "ArxivClusteringP2P": "Identify the main and secondary category of Arxiv papers based on the titles and abstracts",
+    "ArxivClusteringS2S": "Identify the main and secondary category of Arxiv papers based on the titles",
+    "BiorxivClusteringP2P": "Identify the main category of Biorxiv papers based on the titles and abstracts",
+    "BiorxivClusteringS2S": "Identify the main category of Biorxiv papers based on the titles",
+    "MedrxivClusteringP2P": "Identify the main category of Medrxiv papers based on the titles and abstracts",
+    "MedrxivClusteringS2S": "Identify the main category of Medrxiv papers based on the titles",
+    "RedditClustering": "Identify the topic or theme of Reddit posts based on the titles",
+    "RedditClusteringP2P": "Identify the topic or theme of Reddit posts based on the titles and posts",
+    "StackExchangeClustering": "Identify the topic or theme of StackExchange posts based on the titles",
+    "StackExchangeClusteringP2P": "Identify the topic or theme of StackExchange posts based on the given paragraphs",
+    "TwentyNewsgroupsClustering": "Identify the topic or theme of the given news articles",
+    "CLSClusteringS2S": "Identify the main category of scholar papers based on the titles",
+    "CLSClusteringP2P": "Identify the main category of scholar papers based on the titles and abstracts",
+    "ThuNewsClusteringS2S": "Identify the topic or theme of the given news articles based on the titles",
+    "ThuNewsClusteringP2P": "Identify the topic or theme of the given news articles based on the titles and contents",
+    "AskUbuntuDupQuestions": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question",
+    "MindSmallReranking": "Given a query, retrieve documents that answer the query.",
+    "SciDocsRR": "Given a query, retrieve documents that answer the query.",
+    "StackOverflowDupQuestions": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question",
+    "SprintDuplicateQuestions": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question",
+    "TwitterSemEval2015": "Retrieve semantically similar text.",
+    "TwitterURLCorpus": "Retrieve semantically similar text.",
+    "T2Reranking": "Given a query, retrieve documents that answer the query.",
+    "MmarcoReranking": "Given a query, retrieve documents that answer the query.",
+    "CMedQAv1": "Given a query, retrieve documents that answer the query.",
+    "CMedQAv2": "Given a query, retrieve documents that answer the query.",
+    "Ocnli": "Retrieve semantically similar text.",
+    "Cmnli": "Retrieve semantically similar text.",
+    "ArguAna": {
+        "query": "Given a claim, retrieve documents that support or refute the claim",
+        "passage": "Given a claim, retrieve documents that support or refute the claim"
+    },
+    "ClimateFEVER": "Given a claim, retrieve documents that support or refute the claim",
+    "ClimateFEVERHardNegatives": "Given a claim, retrieve documents that support or refute the claim",
+    "DBPedia": "Given a query, retrieve documents that answer the query.",
+    "FEVER": "Given a claim, retrieve documents that support or refute the claim",
+    "FEVERHardNegatives": "Given a claim, retrieve documents that support or refute the claim",
+    "FiQA2018": "Given a query, retrieve documents that answer the query.",
+    "HotpotQA": "Given a multi-hop question, retrieve documents that can help answer the question",
+    "HotpotQAHardNegatives": "Given a multi-hop question, retrieve documents that can help answer the question",
+    "MSMARCO": "Given a web search query, retrieve relevant passages that answer the query",
+    "NFCorpus": "Given a question, retrieve relevant documents that best answer the question",
+    "NQ": "Given a question, retrieve Wikipedia passages that answer the question",
+    "QuoraRetrieval": "Given a query, retrieve documents that answer the query.",
+    "SCIDOCS": "Given a query, retrieve documents that answer the query.",
+    "SciFact": "Given a scientific claim, retrieve documents that support or refute the claim",
+    "Touche2020": "Given a query, retrieve documents that answer the query.",
+    "Touche2020Retrieval.v3": "Given a query, retrieve documents that answer the query.",
+    "TRECCOVID": "Given a query, retrieve documents that answer the query.",
+    "T2Retrieval": "Given a question, retrieve passages that answer the question",
+    "MMarcoRetrieval": "Given a web search query, retrieve relevant passages that answer the query",
+    "DuRetrieval": "Given a question, retrieve passages that answer the question",
+    "CovidRetrieval": "Given a query on COVID-19, retrieve documents that answer the query",
+    "CmedqaRetrieval": "Given a query, retrieve documents that answer the query.",
+    "EcomRetrieval": "Given a query, retrieve documents that answer the query.",
+    "MedicalRetrieval": "Given a query, retrieve documents that answer the query.",
+    "VideoRetrieval": "Given a query, retrieve documents that answer the query.",
+    "STSBenchmarkMultilingualSTS": "Retrieve semantically similar text",
+    "SICKFr": "Retrieve semantically similar text",
+    "SummEvalFr": "Retrieve semantically similar text.",
+    "MasakhaNEWSClassification": "Categorizing the given news title",
+    "OpusparcusPC": "Retrieve semantically similar text",
+    "PawsX": "Retrieve semantically similar text",
+    "AlloProfClusteringP2P": "Identify the main category of scholar papers based on the titles and abstracts",
+    "AlloProfClusteringS2S": "Identify the main category of scholar papers based on the titles",
+    "HALClusteringS2S": "Identify the main category of scholar papers based on the titles",
+    "MasakhaNEWSClusteringP2P": "Identify the topic or theme of the given news articles based on the titles and contents",
+    "MasakhaNEWSClusteringS2S": "Identify the topic or theme of the given news articles based on the titles",
+    "MLSUMClusteringP2P": "Identify the topic or theme of Reddit posts based on the titles and posts",
+    "MLSUMClusteringS2S": "Identify the topic or theme of Reddit posts based on the titles",
+    "SyntecReranking": "Given a question, retrieve passages that answer the question",
+    "AlloprofReranking": "Given a question, retrieve passages that answer the question",
+    "AlloprofRetrieval": "Given a question, retrieve passages that answer the question",
+    "BSARDRetrieval": "Given a question, retrieve passages that answer the question",
+    "SyntecRetrieval": "Given a question, retrieve passages that answer the question",
+    "XPQARetrieval": "Given a question, retrieve passages that answer the question",
+    "MintakaRetrieval": "Given a question, retrieve passages that answer the question",
+    "CBD": "Classifying the sentiment of a given tweet as either positive, negative, or neutral",
+    "PolEmo2.0-IN": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "PolEmo2.0-OUT": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "AllegroReviews": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "PAC": "Classify the sentence into one of the two types: \"BEZPIECZNE_POSTANOWIENIE_UMOWNE\" and \"KLAUZULA_ABUZYWNA\"",
+    "SICK-E-PL": "Retrieve semantically similar text",
+    "SICK-R-PL": "Retrieve semantically similar text",
+    "STS22": "Retrieve semantically similar text",
+    "AFQMC": "Retrieve semantically similar text",
+    "BQ": "Retrieve semantically similar text",
+    "LCQMC": "Retrieve semantically similar text",
+    "PAWSX": "Retrieve semantically similar text",
+    "QBQTC": "Retrieve semantically similar text",
+    "STS12": "Retrieve semantically similar text",
+    "PPC": "Retrieve semantically similar text",
+    "CDSC-E": "Retrieve semantically similar text",
+    "PSC": "Retrieve semantically similar text",
+    "8TagsClustering": "Identify the topic or theme of the given news articles",
+    "ArguAna-PL": "Given a claim, retrieve documents that support or refute the claim",
+    "DBPedia-PL": "Given a query, retrieve documents that answer the query.",
+    "FiQA-PL": "Given a query, retrieve documents that answer the query.",
+    "HotpotQA-PL": "Given a multi-hop question, retrieve documents that can help answer the question",
+    "MSMARCO-PL": "Given a web search query, retrieve relevant passages that answer the query",
+    "NFCorpus-PL": "Given a question, retrieve relevant documents that best answer the question",
+    "NQ-PL": "Given a question, retrieve Wikipedia passages that answer the question",
+    "Quora-PL": "Given a query, retrieve documents that answer the query.",
+    "SCIDOCS-PL": "Given a query, retrieve documents that answer the query.",
+    "SciFact-PL": "Given a scientific claim, retrieve documents that support or refute the claim",
+    "TRECCOVID-PL": "Given a query, retrieve documents that answer the query.",
+    "GeoreviewClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "HeadlineClassification": "Categorizing the given news title",
+    "InappropriatenessClassification": "Classifying the given comments as either toxic or not toxic",
+    "KinopoiskClassification": "Classifying the sentiment expressed in the given movie review text from the IMDB dataset",
+    "RuReviewsClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "RuSciBenchGRNTIClassification": "Categorizing the given news title",
+    "RuSciBenchOECDClassification": "Categorizing the given news title",
+    "GeoreviewClusteringP2P": "Identify the topic or theme of Reddit posts based on the titles and posts",
+    "RuSciBenchGRNTIClusteringP2P": "Identify the main category of scholar papers based on the titles and abstracts",
+    "RuSciBenchOECDClusteringP2P": "Identify the main category of scholar papers based on the titles and abstracts",
+    "TERRa": "Retrieve semantically similar text.",
+    "RuBQReranking": "Given a question, retrieve Wikipedia passages that answer the question",
+    "RiaNewsRetrieval": "Given a query, retrieve documents that answer the query.",
+    "RuBQRetrieval": "Given a question, retrieve Wikipedia passages that answer the question",
+    "RUParaPhraserSTS": "Retrieve semantically similar text",
+    "RuSTSBenchmarkSTS": "Retrieve semantically similar text",
+    "AppsRetrieval": "Given a query, retrieve documents that answer the query.",
+    "COIRCodeSearchNetRetrieval": "Given a query, retrieve documents that answer the query.",
+    "CodeEditSearchRetrieval": "Given a query, retrieve documents that answer the query.",
+    "CodeFeedbackMT": "Given a query, retrieve documents that answer the query.",
+    "CodeFeedbackST": "Given a query, retrieve documents that answer the query.",
+    "CodeSearchNetCCRetrieval": "Given a query, retrieve documents that answer the query.",
+    "CodeSearchNetRetrieval": "Given a query, retrieve documents that answer the query.",
+    "CodeTransOceanContest": "Given a query, retrieve documents that answer the query.",
+    "CodeTransOceanDL": "Given a query, retrieve documents that answer the query.",
+    "CosQA": "Given a query, retrieve documents that answer the query.",
+    "StackOverflowQA": "Given a query, retrieve documents that answer the query.",
+    "SyntheticText2SQL": "Given a query, retrieve documents that answer the query.",
+    "BibleNLPBitextMining": "Retrieve semantically similar text.",
+    "BUCC.v2": "Retrieve semantically similar text.",
+    "DiaBlaBitextMining": "Retrieve semantically similar text.",
+    "FloresBitextMining": "Retrieve semantically similar text.",
+    "IN22GenBitextMining": "Retrieve semantically similar text.",
+    "IndicGenBenchFloresBitextMining": "Retrieve semantically similar text.",
+    "NollySentiBitextMining": "Retrieve semantically similar text.",
+    "NTREXBitextMining": "Retrieve semantically similar text.",
+    "NusaTranslationBitextMining": "Retrieve semantically similar text.",
+    "NusaXBitextMining": "Retrieve semantically similar text.",
+    "Tatoeba": "Retrieve semantically similar text.",
+    "BulgarianStoreReviewSentimentClassfication": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "CzechProductReviewSentimentClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "GreekLegalCodeClassification": "Categorizing the given news title",
+    "DBpediaClassification": "Given an App description text, find the appropriate fine-grained category",
+    "FinancialPhrasebankClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "PoemSentimentClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "TweetTopicSingleClassification": "Categorizing the given news title",
+    "EstonianValenceClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "FilipinoShopeeReviewsClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "GujaratiNewsClassification": "Categorizing the given news title",
+    "SentimentAnalysisHindi": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "IndonesianIdClickbaitClassification": "Categorizing the given news title",
+    "ItaCaseholdClassification": "Categorizing the given news title",
+    "KorSarcasmClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "KurdishSentimentClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "MacedonianTweetSentimentClassification": "Classifying the sentiment of a given tweet as either positive, negative, or neutral",
+    "AfriSentiClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "CataloniaTweetClassification": "Classifying the sentiment of a given tweet as either positive, negative, or neutral",
+    "CyrillicTurkicLangClassification": "Given a text, classify its language",
+    "IndicLangClassification": "Given a text, classify its language",
+    "MultiHateClassification": "Classifying the given comments as either toxic or not toxic",
+    "NusaParagraphEmotionClassification": "Classify the emotion expressed in the given Twitter message into one of the six emotions: anger, fear, joy, love, sadness, and surprise",
+    "NusaX-senti": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "SwissJudgementClassification": "Classifying sentiment of the customer review into positive, neutral, or negative",
+    "NepaliNewsClassification": "Categorizing the given news title",
+    "OdiaNewsClassification": "Categorizing the given news title",
+    "PunjabiNewsClassification": "Categorizing the given news title",
+    "SinhalaNewsClassification": "Categorizing the given news title",
+    "CSFDSKMovieReviewSentimentClassification": "Classifying the sentiment expressed in the given movie review text from the IMDB dataset",
+    "SiswatiNewsClassification": "Categorizing the given news title",
+    "SlovakMovieReviewSentimentClassification": "Classifying the sentiment expressed in the given movie review text from the IMDB dataset",
+    "SwahiliNewsClassification": "Categorizing the given news title",
+    "TswanaNewsClassification": "Categorizing the given news title",
+    "IsiZuluNewsClassification": "Categorizing the given news title",
+    "WikiCitiesClustering": "Identify the topic or theme of the given news articles",
+    "RomaniBibleClustering": "Identify the topic or theme of the given news articles",
+    "ArXivHierarchicalClusteringP2P": "Identify the main and secondary category of Arxiv papers based on the titles and abstracts",
+    "ArXivHierarchicalClusteringS2S": "Identify the main and secondary category of Arxiv papers based on the titles",
+    "BigPatentClustering.v2": "Identify the main category of scholar papers based on the titles and abstracts",
+    "AlloProfClusteringS2S.v2": "Identify the main category of scholar papers based on the titles",
+    "HALClusteringS2S.v2": "Identify the main category of scholar papers based on the titles",
+    "SIB200ClusteringS2S": "Identify the topic or theme of the given news articles",
+    "WikiClusteringP2P.v2": "Identify the topic or theme of the given news articles",
+    "PlscClusteringP2P.v2": "Identify the main category of scholar papers based on the titles and abstracts",
+    "KorHateSpeechMLClassification": "Classifying the given comments as either toxic or not toxic",
+    "MalteseNewsClassification": "Categorizing the given news title",
+    "MultiEURLEXMultilabelClassification": "Categorizing the given news title",
+    "BrazilianToxicTweetsClassification": "Classifying the given comments as either toxic or not toxic",
+    "CTKFactsNLI": "Retrieve semantically similar text",
+    "indonli": "Retrieve semantically similar text",
+    "ArmenianParaphrasePC": "Retrieve semantically similar text",
+    "PawsXPairClassification": "Retrieve semantically similar text",
+    "RTE3": "Retrieve semantically similar text",
+    "XNLI": "Retrieve semantically similar text",
+    "PpcPC": "Retrieve semantically similar text",
+    "GermanSTSBenchmark": "Retrieve semantically similar text",
+    "SICK-R": "Retrieve semantically similar text",
+    "STS13": "Retrieve semantically similar text",
+    "STS14": "Retrieve semantically similar text",
+    "STSBenchmark": "Retrieve semantically similar text",
+    "FaroeseSTS": "Retrieve semantically similar text",
+    "FinParaSTS": "Retrieve semantically similar text",
+    "JSICK": "Retrieve semantically similar text",
+    "IndicCrosslingualSTS": "Retrieve semantically similar text",
+    "SemRel24STS": "Retrieve semantically similar text",
+    "STS17": "Retrieve semantically similar text",
+    "STS22.v2": "Retrieve semantically similar text",
+    "STSES": "Retrieve semantically similar text",
+    "STSB": "Retrieve semantically similar text",
+    "AILAStatutes": "Given a query, retrieve documents that answer the query.",
+    "HagridRetrieval": "Given a query, retrieve documents that answer the query.",
+    "LegalBenchCorporateLobbying": "Given a query, retrieve documents that answer the query.",
+    "LEMBPasskeyRetrieval": "Given a query, retrieve documents that answer the query.",
+    "BelebeleRetrieval": "Given a query, retrieve documents that answer the query.",
+    "MLQARetrieval": "Given a query, retrieve documents that answer the query.",
+    "StatcanDialogueDatasetRetrieval": "Given a query, retrieve documents that answer the query.",
+    "WikipediaRetrievalMultilingual": "Given a query, retrieve documents that answer the query.",
+    "Core17InstructionRetrieval": "Given a query, retrieve documents that answer the query.",
+    "News21InstructionRetrieval": "Given a query, retrieve documents that answer the query.",
+    "Robust04InstructionRetrieval": "Given a query, retrieve documents that answer the query.",
+    "WebLINXCandidatesReranking": "Given a query, retrieve documents that answer the query.",
+    "WikipediaRerankingMultilingual": "Given a query, retrieve documents that answer the query.",
+    "STS15": "Retrieve semantically similar text",
+    "MIRACLRetrievalHardNegatives": "Given a question, retrieve passages that answer the question",
+    "BIOSSES": "Retrieve semantically similar text",
+    "CQADupstackRetrieval": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question",
+    "CQADupstackGamingRetrieval": {
+        "query": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question",
+        "passage": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question"
+    },
+    "CQADupstackUnixRetrieval": {
+        "query": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question",
+        "passage": "Given a question, retrieve detailed question descriptions from Stackexchange that are duplicates to the given question"
+    },
+    "STS16": "Retrieve semantically similar text",
+    "SummEval": "Retrieve semantically similar text",
+    "ATEC": "Retrieve semantically similar text"
+}

sentence_bert_config.json

@@ -0,0 +1,4 @@
+{
+    "max_seq_length": 512,
+    "do_lower_case": false
+}

special_tokens_map.json

@@ -0,0 +1,34 @@
+{
+  "boi_token": "<start_of_image>",
+  "bos_token": {
+    "content": "<bos>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "eoi_token": "<end_of_image>",
+  "eos_token": {
+    "content": "<eos>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "image_token": "<image_soft_token>",
+  "mask_token": "<|mask|>",
+  "pad_token": {
+    "content": "<pad>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "unk_token": {
+    "content": "<unk>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  }
+}

tokenizer.json

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

tokenizer.model

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1299c11d7cf632ef3b4e11937501358ada021bbdf7c47638d13c0ee982f2e79c
+size 4689074