first commit

tests/models/colmodernvbert/test_modeling_colmodernvbert.py

@@ -0,0 +1,259 @@
+# Copyright 2026 The 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.
+"""Testing suite for the PyTorch ColModernVBert model."""
+
+import unittest
+from typing import ClassVar
+
+from huggingface_hub import hf_hub_download
+from PIL import Image
+
+from tests.test_configuration_common import ConfigTester
+from tests.test_modeling_common import ModelTesterMixin, floats_tensor, ids_tensor
+from transformers import (
+    is_torch_available,
+)
+from transformers.models.colmodernvbert.configuration_colmodernvbert import ColModernVBertConfig
+from transformers.models.colmodernvbert.modeling_colmodernvbert import (
+    ColModernVBertForRetrieval,
+    ColModernVBertForRetrievalOutput,
+)
+from transformers.models.colmodernvbert.processing_colmodernvbert import ColModernVBertProcessor
+from transformers.testing_utils import (
+    cleanup,
+    require_torch,
+    require_vision,
+    slow,
+    torch_device,
+)
+
+
+if is_torch_available():
+    import torch
+
+
+class ColModernVBertForRetrievalModelTester:
+    def __init__(
+        self,
+        parent,
+        batch_size=2,
+        num_images=2,
+        seq_length=7,
+        ignore_index=-100,
+        text_config=None,
+        is_training=False,
+        vision_config=None,
+        pixel_shuffle_factor=2,
+        embedding_dim=64,
+    ):
+        if text_config is None:
+            text_config = {
+                "vocab_size": 99,
+                "pad_token_id": 0,
+                "hidden_size": 32,
+                "num_hidden_layers": 2,
+                "num_attention_heads": 2,
+                "intermediate_size": 64,
+                "hidden_activation": "gelu",
+                "mlp_dropout": 0.1,
+                "embedding_dropout": 0.1,
+                "classifier_dropout": 0.1,
+                "max_position_embeddings": 512,
+                "type_vocab_size": 2,
+                "is_decoder": False,
+                "initializer_range": 0.02,
+                "reference_compile": False,
+            }
+        if vision_config is None:
+            vision_config = {
+                "image_size": 16,
+                "patch_size": 4,
+                "hidden_size": 64,
+                "num_hidden_layers": 2,
+                "num_attention_heads": 4,
+                "intermediate_size": 32,
+                "dropout": 0.1,
+                "attention_dropout": 0.1,
+                "initializer_range": 0.02,
+                "vision_use_head": False,
+            }
+        self.is_training = is_training
+        self.parent = parent
+        self.batch_size = batch_size
+        self.text_config = text_config
+        self.vision_config = vision_config
+        self.num_images = num_images
+        self.image_size = vision_config["image_size"]
+        self.pixel_shuffle_factor = pixel_shuffle_factor
+        self.image_token_id = self.text_config["vocab_size"] - 1
+        self.pad_token_id = text_config["pad_token_id"]
+        self.image_seq_length = (
+            int(((vision_config["image_size"] // vision_config["patch_size"]) ** 2) / (pixel_shuffle_factor**2))
+            * self.num_images
+        )
+        self.seq_length = seq_length + self.image_seq_length
+
+        self.hidden_size = text_config["hidden_size"]
+        self.num_hidden_layers = text_config["num_hidden_layers"]
+        self.num_attention_heads = text_config["num_attention_heads"]
+        self.ignore_index = ignore_index
+
+        self.embedding_dim = embedding_dim
+        self.vlm_config = {
+            "model_type": "modernvbert",
+            "text_config": self.text_config,
+            "vision_config": self.vision_config,
+            "image_token_id": self.image_token_id,
+            "pixel_shuffle_factor": self.pixel_shuffle_factor,
+        }
+
+    def get_config(self):
+        config = ColModernVBertConfig(
+            vlm_config=self.vlm_config,
+            embedding_dim=self.embedding_dim,
+        )
+        return config
+
+    def prepare_config_and_inputs(self):
+        pixel_values = floats_tensor([self.batch_size, self.num_images, 3, self.image_size, self.image_size])
+        config = self.get_config()
+
+        return config, pixel_values
+
+    def prepare_config_and_inputs_for_common(self):
+        config_and_inputs = self.prepare_config_and_inputs()
+        config, pixel_values = config_and_inputs
+        input_ids = ids_tensor([self.batch_size, self.seq_length], config.vlm_config.text_config.vocab_size)
+        attention_mask = torch.ones(input_ids.shape, dtype=torch.long).to(torch_device)
+
+        # For simplicity just set the first n tokens to the image token
+        input_ids[input_ids == self.image_token_id] = self.pad_token_id
+        input_ids[:, : self.image_seq_length] = self.image_token_id
+        attention_mask = input_ids.ne(1).to(torch_device)
+        inputs_dict = {
+            "pixel_values": pixel_values,
+            "input_ids": input_ids,
+            "attention_mask": attention_mask,
+        }
+        return config, inputs_dict
+
+
+@require_torch
+class ColModernVBertForRetrievalModelTest(ModelTesterMixin, unittest.TestCase):
+    """
+    Model tester for `ColModernVBertForRetrieval`.
+    """
+
+    all_model_classes = (ColModernVBertForRetrieval,) if is_torch_available() else ()
+
+    test_resize_embeddings = True
+    test_missing_keys = False
+    model_split_percents = [0.5, 0.8, 0.9]
+
+    def setUp(self):
+        self.model_tester = ColModernVBertForRetrievalModelTester(self)
+        self.config_tester = ConfigTester(self, config_class=ColModernVBertConfig, has_text_modality=False)
+
+    @require_vision
+    def test_colmodernvbert_forward_inputs(self):
+        config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common()
+
+        for model_class in self.all_model_classes:
+            model = model_class(config)
+            model.to(torch_device)
+            model.eval()
+
+            inputs = self._prepare_for_class(inputs_dict, model_class)
+
+            with torch.no_grad():
+                outputs = model(**inputs, return_dict=True)
+
+            self.assertIsInstance(outputs, ColModernVBertForRetrievalOutput)
+
+    @unittest.skip(reason="Error related to ModernBERT model parallelism: self.dtype is broken.")
+    def test_multi_gpu_data_parallel_forward(self):
+        pass
+
+
+@require_torch
+class ColModernVBertModelIntegrationTest(unittest.TestCase):
+    model_name: ClassVar[str] = "paultltc/colmodernvbert_hf"
+
+    def setUp(self):
+        self.model_dtype = torch.float32
+        self.processor = ColModernVBertProcessor.from_pretrained(self.model_name)
+        self.model = (
+            ColModernVBertForRetrieval.from_pretrained(
+                self.model_name,
+                dtype=self.model_dtype,
+            )
+            .to(torch_device)
+            .eval()
+        )
+
+    def tearDown(self):
+        cleanup(torch_device, gc_collect=True)
+
+    @slow
+    def test_model_integration_test(self):
+        """
+        Test if the model is able to retrieve the correct pages for a small and easy dataset.
+        """
+        # Load the test dataset
+        queries = [
+            "A paint on the wall",
+            "ColModernVBERT matches the performance of models nearly 10x larger on visual document benchmarks.",
+        ]
+
+        images = [
+            Image.open(hf_hub_download("HuggingFaceTB/SmolVLM", "example_images/rococo.jpg", repo_type="space")),
+            Image.open(hf_hub_download("ModernVBERT/colmodernvbert", "table.png", repo_type="model")),
+        ]
+
+        # Preprocess the examples
+        batch_queries = self.processor.process_queries(text=queries).to(torch_device)
+        batch_images = self.processor.process_images(images=images).to(torch_device)
+
+        # Run inference
+        with torch.inference_mode():
+            image_embeddings = self.model(**batch_images).embeddings
+            query_embeddings = self.model(**batch_queries).embeddings
+
+        # Compute retrieval scores
+        scores = self.processor.score_retrieval(
+            query_embeddings=query_embeddings,
+            passage_embeddings=image_embeddings,
+        )  # (num_queries, num_passages)
+
+        scores = torch.softmax(scores, dim=-1)
+
+        self.assertTrue(scores.ndim == 2, f"Expected 2D tensor, got {scores.ndim}")
+        (
+            self.assertTrue(scores.shape == (len(images), len(images))),
+            (f"Expected shape {(len(images), len(images))}, got {scores.shape}"),
+        )
+
+        # Check if the maximum scores per row are in the diagonal of the matrix score
+        self.assertTrue((scores.argmax(axis=1) == torch.arange(len(images), device=scores.device)).all())
+
+        # Further validation: fine-grained check, with a hardcoded score from the original implementation
+        expected_scores = torch.tensor(
+            [[0.95181, 0.048189], [0.00057251, 0.99943]],
+            dtype=scores.dtype,
+        )
+
+        (
+            self.assertTrue(torch.allclose(scores, expected_scores, atol=1e-2)),
+            f"Expected scores {expected_scores}, got {scores}",
+        )

tests/models/colmodernvbert/test_processing_colmodernvbert.py

@@ -0,0 +1,324 @@
+# Copyright 2026 HuggingFace Inc.
+#
+# 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.
+"""Testing suite for the ColModernVBert processor."""
+
+import shutil
+import tempfile
+import unittest
+
+import torch
+from parameterized import parameterized
+
+from transformers.models.colmodernvbert.processing_colmodernvbert import ColModernVBertProcessor
+from transformers.testing_utils import get_tests_dir, require_torch, require_vision
+from transformers.utils import is_vision_available
+
+from ...test_processing_common import ProcessorTesterMixin
+
+
+if is_vision_available():
+    from transformers import (
+        ColModernVBertProcessor,
+    )
+
+SAMPLE_VOCAB = get_tests_dir("fixtures/vocab.txt")
+
+
+@require_vision
+class ColModernVBertProcessorTest(ProcessorTesterMixin, unittest.TestCase):
+    processor_class = ColModernVBertProcessor
+
+    @classmethod
+    def setUpClass(cls):
+        cls.tmpdirname = tempfile.mkdtemp()
+        processor = ColModernVBertProcessor.from_pretrained("ModernVBERT/colmodernvbert")
+        processor.save_pretrained(cls.tmpdirname)
+
+    @classmethod
+    def tearDownClass(cls):
+        shutil.rmtree(cls.tmpdirname, ignore_errors=True)
+
+    @require_torch
+    @require_vision
+    def test_process_images(self):
+        # Processor configuration
+        image_input = self.prepare_image_inputs()
+        image_processor = self.get_component("image_processor")
+        tokenizer = self.get_component("tokenizer", max_length=112, padding="max_length")
+
+        # Get the processor
+        processor = self.processor_class(
+            tokenizer=tokenizer,
+            image_processor=image_processor,
+        )
+
+        # Process the image
+        batch_feature = processor.process_images(images=image_input, return_tensors="pt")
+
+        # Assertions
+        self.assertIn("pixel_values", batch_feature)
+        # ModernVBert/Idefics3 usually resizes to something specific or keeps aspect ratio.
+        # Let's check if pixel_values are present and have correct type.
+        self.assertIsInstance(batch_feature["pixel_values"], torch.Tensor)
+        # Shape depends on image processor config, so we might not want to hardcode it unless we know defaults.
+        # Idefics3 default size is often dynamic or specific.
+
+    @require_torch
+    @require_vision
+    def test_process_queries(self):
+        # Inputs
+        queries = [
+            "Is attention really all you need?",
+            "Are Benjamin, Antoine, Merve, and Jo best friends?",
+        ]
+
+        # Processor configuration
+        image_processor = self.get_component("image_processor")
+        tokenizer = self.get_component("tokenizer", max_length=112, padding="max_length")
+
+        # Get the processor
+        processor = self.processor_class(
+            tokenizer=tokenizer,
+            image_processor=image_processor,
+        )
+
+        # Process the queries
+        batch_feature = processor.process_queries(text=queries, return_tensors="pt")
+
+        # Assertions
+        self.assertIn("input_ids", batch_feature)
+        self.assertIsInstance(batch_feature["input_ids"], torch.Tensor)
+        self.assertEqual(batch_feature["input_ids"].shape[0], len(queries))
+
+    # The following tests override the parent tests because ColModernVBertProcessor can only take one of images or text as input at a time.
+
+    def test_tokenizer_defaults_preserved_by_kwargs(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor_components["tokenizer"] = self.get_component("tokenizer", max_length=117, padding="max_length")
+
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+        input_str = self.prepare_text_inputs()
+        inputs = processor(text=input_str, return_tensors="pt")
+        self.assertEqual(inputs[self.text_input_name].shape[-1], 117)
+
+    def test_image_processor_defaults_preserved_by_image_kwargs(self):
+        """
+        We use do_rescale=True, rescale_factor=-1.0 to ensure that image_processor kwargs are preserved in the processor.
+        We then check that the mean of the pixel_values is less than or equal to 0 after processing.
+        Since the original pixel_values are in [0, 255], this is a good indicator that the rescale_factor is indeed applied.
+        """
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor_components["image_processor"] = self.get_component(
+            "image_processor", do_rescale=True, rescale_factor=-1.0
+        )
+        processor_components["tokenizer"] = self.get_component("tokenizer", max_length=117, padding="max_length")
+
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        image_input = self.prepare_image_inputs()
+
+        inputs = processor(images=image_input, return_tensors="pt")
+        self.assertLessEqual(inputs[self.images_input_name][0][0].mean(), 0)
+
+    def test_kwargs_overrides_default_tokenizer_kwargs(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor_components["tokenizer"] = self.get_component("tokenizer", padding="longest")
+
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+        input_str = self.prepare_text_inputs()
+        inputs = processor(text=input_str, return_tensors="pt", max_length=112, padding="max_length")
+        self.assertEqual(inputs[self.text_input_name].shape[-1], 112)
+
+    def test_kwargs_overrides_default_image_processor_kwargs(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor_components["image_processor"] = self.get_component(
+            "image_processor", do_rescale=True, rescale_factor=1
+        )
+        processor_components["tokenizer"] = self.get_component("tokenizer", max_length=117, padding="max_length")
+
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        image_input = self.prepare_image_inputs()
+
+        inputs = processor(images=image_input, do_rescale=True, rescale_factor=-1.0, return_tensors="pt")
+        self.assertLessEqual(inputs[self.images_input_name][0][0].mean(), 0)
+
+    def test_unstructured_kwargs(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        input_str = self.prepare_text_inputs()
+        inputs = processor(
+            text=input_str,
+            return_tensors="pt",
+            do_rescale=True,
+            rescale_factor=-1.0,
+            padding="max_length",
+            max_length=76,
+        )
+
+        self.assertEqual(inputs[self.text_input_name].shape[-1], 76)
+
+    def test_unstructured_kwargs_batched(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        image_input = self.prepare_image_inputs(batch_size=2)
+        inputs = processor(
+            images=image_input,
+            return_tensors="pt",
+            do_rescale=True,
+            rescale_factor=-1.0,
+            padding="longest",
+            max_length=76,
+        )
+
+        self.assertLessEqual(inputs[self.images_input_name][0][0].mean(), 0)
+
+    def test_doubly_passed_kwargs(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        image_input = self.prepare_image_inputs()
+        with self.assertRaises(ValueError):
+            _ = processor(
+                images=image_input,
+                images_kwargs={"do_rescale": True, "rescale_factor": -1.0},
+                do_rescale=True,
+                return_tensors="pt",
+            )
+
+    def test_structured_kwargs_nested(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        input_str = self.prepare_text_inputs()
+
+        # Define the kwargs for each modality
+        all_kwargs = {
+            "common_kwargs": {"return_tensors": "pt"},
+            "images_kwargs": {"do_rescale": True, "rescale_factor": -1.0},
+            "text_kwargs": {"padding": "max_length", "max_length": 15, "truncation": True},
+        }
+
+        inputs = processor(text=input_str, **all_kwargs)
+        self.skip_processor_without_typed_kwargs(processor)
+
+        self.assertEqual(inputs[self.text_input_name].shape[-1], 15)
+
+    def test_structured_kwargs_nested_from_dict(self):
+        if "image_processor" not in self.processor_class.get_attributes():
+            self.skipTest(f"image_processor attribute not present in {self.processor_class}")
+        processor_components = self.prepare_components()
+        processor = self.processor_class(**processor_components)
+        self.skip_processor_without_typed_kwargs(processor)
+        image_input = self.prepare_image_inputs()
+
+        # Define the kwargs for each modality
+        all_kwargs = {
+            "common_kwargs": {"return_tensors": "pt"},
+            "images_kwargs": {"do_rescale": True, "rescale_factor": -1.0},
+        }
+
+        inputs = processor(images=image_input, **all_kwargs)
+        self.assertLessEqual(inputs[self.images_input_name][0][0].mean(), 0)
+
+    # Can process only text or images at a time
+    def test_model_input_names(self):
+        processor = self.get_processor()
+        image_input = self.prepare_image_inputs()
+        inputs = processor(images=image_input)
+        # When only images are provided, pixel_values must be present
+        self.assertIn("pixel_values", inputs)
+
+    @unittest.skip(reason="ColModernVBert is meant to be used through `process_queries` or `process_images`.")
+    def test_tokenizer_defaults(self):
+        pass
+
+    @unittest.skip("ColModernVBert can't process text+image inputs at the same time")
+    def test_processor_text_has_no_visual(self):
+        pass
+
+    @unittest.skip("ColModernVBert can't process text+image inputs at the same time")
+    def test_processor_with_multiple_inputs(self):
+        pass
+
+    @unittest.skip("ColModernVBert can't process text+image inputs at the same time")
+    def test_get_num_multimodal_tokens_matches_processor_call(self):
+        pass
+
+    @unittest.skip("ColModernVBert can't process text+image inputs at the same time")
+    def test_flat_kwarg_applied_when_modality_dict_lacks_it(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_chat_template_save_loading(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_apply_chat_template_audio(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_apply_chat_template_decoded_video(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_apply_chat_template_video(self):
+        pass
+
+    @parameterized.expand([(1, "pt"), (2, "pt")])
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_apply_chat_template_image(self, batch_size, return_tensors):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_apply_chat_template_video_frame_sampling(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_chat_template_audio_from_video(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_chat_template_jinja_kwargs(self):
+        pass
+
+    @unittest.skip("ColModernVBert does not have a chat template")
+    def test_apply_chat_template_assistant_mask(self):
+        pass