Image-Text-to-Text
PEFT
Safetensors
English
lora
cvpd
self-distillation
multimodal
vision-language
lmm
ocr
qwen3-vl
unsupervised
conversational
Instructions to use shravvvv/CVPD with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use shravvvv/CVPD with PEFT:
from peft import PeftModel from transformers import AutoModelForCausalLM base_model = AutoModelForCausalLM.from_pretrained("Qwen/Qwen3-VL-8B-Instruct") model = PeftModel.from_pretrained(base_model, "shravvvv/CVPD") - Notebooks
- Google Colab
- Kaggle
Simplify model card; BMVC 2026 citation
Browse files
README.md
CHANGED
|
@@ -11,47 +11,33 @@ tags:
|
|
| 11 |
- peft
|
| 12 |
- cvpd
|
| 13 |
- self-distillation
|
| 14 |
-
- self-evolving
|
| 15 |
- multimodal
|
| 16 |
- vision-language
|
| 17 |
- lmm
|
| 18 |
- ocr
|
| 19 |
-
- visual-perception
|
| 20 |
- qwen3-vl
|
| 21 |
- unsupervised
|
| 22 |
---
|
| 23 |
|
| 24 |
-
# CVPD
|
| 25 |
|
| 26 |
-
This is the CVPD LoRA adapter for `Qwen/Qwen3-VL-4B-Instruct`, from our paper
|
| 27 |
[Perception Before Supervision: Self-Contained Visual Distillation from Counterfactual Blind Spots](https://github.com/mbzuai-oryx/CVPD).
|
| 28 |
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
|
| 33 |
-
|
| 34 |
-
|
| 35 |
-
|
| 36 |
-
|
| 37 |
-
|
| 38 |
-
|
| 39 |
-
|
| 40 |
-
|
| 41 |
-
|
| 42 |
-
|
| 43 |
-
- **Phase 1 — Counterfactual Blind-Spot Discovery.** The model generates its own
|
| 44 |
-
fine-grained question and probe answer per image, proposes candidate regions from
|
| 45 |
-
three tracks (self-grounding, a 3x3 grid, and a 2x2 grid), and keeps only regions
|
| 46 |
-
passing a three-gate Counterfactual Criterion: latent capability divergence
|
| 47 |
-
(the crop moves the answer distribution), default perceptual invariance (the
|
| 48 |
-
ghosted image does not), and epistemic sharpening (the crop lowers entropy).
|
| 49 |
-
- **Phase 2 — Contrastive Self-Distillation.** Each retained region instantiates
|
| 50 |
-
four policies from the same backbone: an online student, a crop-conditioned
|
| 51 |
-
positive teacher, a ghost-conditioned negative teacher, and a frozen reference
|
| 52 |
-
policy. The student is pulled toward the crop teacher (latent transfer), pushed
|
| 53 |
-
away from the ghost teacher (contrastive ranking, margin `m=0.1`), and anchored
|
| 54 |
-
to the reference policy (adaptive KL, target `0.03`).
|
| 55 |
|
| 56 |
## Usage
|
| 57 |
|
|
@@ -84,41 +70,15 @@ with torch.inference_mode():
|
|
| 84 |
print(processor.batch_decode(out[:, inputs["input_ids"].shape[1]:], skip_special_tokens=True)[0])
|
| 85 |
```
|
| 86 |
|
| 87 |
-
## Results (Qwen3-VL-4B-Instruct)
|
| 88 |
-
|
| 89 |
-
| Benchmark | Base | CVPD |
|
| 90 |
-
| --- | --- | --- |
|
| 91 |
-
| OCRBench | 81.70 | 84.35 |
|
| 92 |
-
| MMStar Fine-Grained Perception | 60.86 | 63.35 |
|
| 93 |
-
| MMStar Logical Reasoning | 62.96 | 65.25 |
|
| 94 |
-
| MMStar Instance Reasoning | 69.83 | 71.20 |
|
| 95 |
-
| InfoVQA | 77.73 | 79.15 |
|
| 96 |
-
| ScienceQA | 87.51 | 89.05 |
|
| 97 |
-
| AI2D | 80.10 | 82.35 |
|
| 98 |
-
| CV-Bench | 85.45 | 87.15 |
|
| 99 |
-
| RealWorldQA | 71.24 | 73.45 |
|
| 100 |
-
| MMBench-EN | 83.51 | 84.60 |
|
| 101 |
-
| MME-Perception | 1702.9 | 1715.5 |
|
| 102 |
-
| SEED-Image | 78.05 | 78.20 |
|
| 103 |
-
|
| 104 |
-
The largest gains appear on benchmarks requiring precise localized attention —
|
| 105 |
-
OCRBench (+2.65), MMStar Fine-Grained Perception (+2.49), and MMStar Logical
|
| 106 |
-
Reasoning (+2.29). CVPD is the only method in our comparison that improves over
|
| 107 |
-
the base model on every benchmark without regressing on any, at both the 4B and
|
| 108 |
-
8B scales. Full results, ablations, and the 8B model are in our paper.
|
| 109 |
-
|
| 110 |
## Training
|
| 111 |
|
| 112 |
-
- Base: `Qwen/Qwen3-VL-4B-Instruct`, vision encoder frozen.
|
| 113 |
-
- LoRA: `r=32`, `alpha=64` on the attention and MLP projections
|
| 114 |
-
|
| 115 |
-
-
|
| 116 |
-
|
| 117 |
-
-
|
| 118 |
-
|
| 119 |
-
- Data: 15,000 raw, unlabeled images (10,000 natural-scene + 5,000 reasoning-domain),
|
| 120 |
-
yielding ~2,590 curated blind-spot tuples (17.2% pass rate). No captions,
|
| 121 |
-
bounding boxes, labels, answers, or reward signals are used at any stage.
|
| 122 |
|
| 123 |
## License
|
| 124 |
|
|
@@ -127,11 +87,11 @@ Apache 2.0.
|
|
| 127 |
## Citation
|
| 128 |
|
| 129 |
```bibtex
|
| 130 |
-
@
|
| 131 |
-
|
| 132 |
-
|
| 133 |
-
|
| 134 |
-
|
| 135 |
-
|
| 136 |
}
|
| 137 |
```
|
|
|
|
| 11 |
- peft
|
| 12 |
- cvpd
|
| 13 |
- self-distillation
|
|
|
|
| 14 |
- multimodal
|
| 15 |
- vision-language
|
| 16 |
- lmm
|
| 17 |
- ocr
|
|
|
|
| 18 |
- qwen3-vl
|
| 19 |
- unsupervised
|
| 20 |
---
|
| 21 |
|
| 22 |
+
# CVPD
|
| 23 |
|
| 24 |
+
This is the CVPD LoRA adapter for `Qwen/Qwen3-VL-4B-Instruct`, from our BMVC 2026 paper
|
| 25 |
[Perception Before Supervision: Self-Contained Visual Distillation from Counterfactual Blind Spots](https://github.com/mbzuai-oryx/CVPD).
|
| 26 |
|
| 27 |
+
Vision-language models often miss details they can actually see. Ask about a small
|
| 28 |
+
sign in a photo and the model gets it wrong, but crop to that sign and it answers
|
| 29 |
+
correctly. The information was there, the model just didn't attend to it.
|
| 30 |
+
|
| 31 |
+
CVPD trains models to fix this using nothing but the model itself. We show it an
|
| 32 |
+
unlabeled image, let it write its own question, and then check two things: does
|
| 33 |
+
zooming into a region change and sharpen its answer, and does blurring that region
|
| 34 |
+
leave its answer alone? When both hold, we've found a blind spot: something the
|
| 35 |
+
model can perceive but doesn't use. We then train the model on the full image to
|
| 36 |
+
behave the way it did on the crop, and away from how it behaved on the blurred
|
| 37 |
+
version.
|
| 38 |
+
|
| 39 |
+
No captions, no bounding boxes, no labels, no reward models, no bigger teacher
|
| 40 |
+
model. Just the model and a pile of raw images.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 41 |
|
| 42 |
## Usage
|
| 43 |
|
|
|
|
| 70 |
print(processor.batch_decode(out[:, inputs["input_ids"].shape[1]:], skip_special_tokens=True)[0])
|
| 71 |
```
|
| 72 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 73 |
## Training
|
| 74 |
|
| 75 |
+
- Base model: `Qwen/Qwen3-VL-4B-Instruct`, with the vision encoder frozen.
|
| 76 |
+
- LoRA: `r=32`, `alpha=64`, `dropout=0.05`, on the attention and MLP projections
|
| 77 |
+
of the language model.
|
| 78 |
+
- AdamW, learning rate `2e-5`, weight decay `0.01`, gradient clipping `1.0`, bfloat16.
|
| 79 |
+
- One epoch over the curated blind-spot pool.
|
| 80 |
+
- Data: 15,000 raw unlabeled images, which the discovery pipeline narrows down to
|
| 81 |
+
about 2,590 training examples.
|
|
|
|
|
|
|
|
|
|
| 82 |
|
| 83 |
## License
|
| 84 |
|
|
|
|
| 87 |
## Citation
|
| 88 |
|
| 89 |
```bibtex
|
| 90 |
+
@inproceedings{cvpd,
|
| 91 |
+
author = {Venkatraman, Shravan and Thawakar, Omkar and Thawkar, Ritesh and Shaker, Abdelrahman and Muhammad, Rao},
|
| 92 |
+
title = {Perception Before Supervision: Self-Contained Visual Distillation from Counterfactual Blind Spots},
|
| 93 |
+
booktitle = {37th British Machine Vision Conference 2026, {BMVC} 2026, Lancaster, UK, November 23-26, 2026},
|
| 94 |
+
publisher = {BMVA},
|
| 95 |
+
year = {2026}
|
| 96 |
}
|
| 97 |
```
|