Instructions to use ruotian/SelectGround-8B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use ruotian/SelectGround-8B 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, "ruotian/SelectGround-8B") - Notebooks
- Google Colab
- Kaggle
Release ClickContrast-trained SelectGround-8B
Browse files- README.md +52 -0
- adapter_config.json +48 -0
- adapter_model.safetensors +3 -0
- selection_head.pt +3 -0
README.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
library_name: peft
|
| 4 |
+
base_model: Qwen/Qwen3-VL-8B-Instruct
|
| 5 |
+
base_model_relation: adapter
|
| 6 |
+
datasets:
|
| 7 |
+
- ruotian/ClickContrast
|
| 8 |
+
pipeline_tag: image-text-to-text
|
| 9 |
+
tags:
|
| 10 |
+
- gui-grounding
|
| 11 |
+
- computer-use
|
| 12 |
+
- qwen3-vl
|
| 13 |
+
- lora
|
| 14 |
+
- selectground
|
| 15 |
+
---
|
| 16 |
+
|
| 17 |
+
# SelectGround-8B
|
| 18 |
+
|
| 19 |
+
SelectGround maps a screenshot and instruction to one click.
|
| 20 |
+
It learns from target–distractor pairs using coordinate supervision and an auxiliary attention-based selection loss.
|
| 21 |
+
Latent Competitor Revisit (LCR) reuses the learned selector to revisit competing regions and compare independently decoded coordinates.
|
| 22 |
+
|
| 23 |
+
| Inference | ScreenSpot-Pro | MMBench-GUI L2 | OSWorld-G |
|
| 24 |
+
|---|---:|---:|---:|
|
| 25 |
+
| Direct | 66.034 | 86.283 | 70.196 |
|
| 26 |
+
| LCR | 73.182 | 88.008 | 71.961 |
|
| 27 |
+
|
| 28 |
+
Results use all 1,581 ScreenSpot-Pro and 3,594 MMBench-GUI L2 examples, and the 510 target-bearing OSWorld-G examples.
|
| 29 |
+
The LCR comparison weights are fixed per benchmark and documented in the code repository.
|
| 30 |
+
|
| 31 |
+
## Contents
|
| 32 |
+
|
| 33 |
+
This release contains the LoRA adapter and the auxiliary selection head.
|
| 34 |
+
The inference code loads them on **Qwen/Qwen3-VL-8B-Instruct** at revision **0c351dd01ed87e9c1b53cbc748cba10e6187ff3b**.
|
| 35 |
+
It uses the backbone's frozen visual encoder and merger.
|
| 36 |
+
This is one directly trained checkpoint, not an average of checkpoints.
|
| 37 |
+
|
| 38 |
+
## Use and reproduce
|
| 39 |
+
|
| 40 |
+
See [SelectGround](https://github.com/zhangruotian/SelectGround) for installation, the exact training recipe, direct inference, LCR, and evaluation of all three benchmarks.
|
| 41 |
+
|
| 42 |
+
~~~bash
|
| 43 |
+
python infer.py --model ruotian/SelectGround-8B --image screenshot.png --instruction "Click the Save button"
|
| 44 |
+
python infer.py --model ruotian/SelectGround-8B --image screenshot.png --instruction "Click the Save button" --lcr
|
| 45 |
+
~~~
|
| 46 |
+
|
| 47 |
+
Output **point** is in original-image pixels. **normalized_point** uses 0–1000 coordinates.
|
| 48 |
+
Generation is greedy, uses at most 32 tokens, and preserves the image aspect ratio under an 8,847,360-pixel budget.
|
| 49 |
+
|
| 50 |
+
Training starts from the pinned backbone with seed 20260625 and uses [ClickContrast](https://huggingface.co/datasets/ruotian/ClickContrast).
|
| 51 |
+
The selected recipe uses 110 initial-stage updates followed by 10 refinement updates.
|
| 52 |
+
The code release fixes the full schedules, sampling, loss, and optimizer-state boundaries.
|
adapter_config.json
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"alora_invocation_tokens": null,
|
| 3 |
+
"alpha_pattern": {},
|
| 4 |
+
"arrow_config": null,
|
| 5 |
+
"auto_mapping": null,
|
| 6 |
+
"base_model_name_or_path": "Qwen/Qwen3-VL-8B-Instruct",
|
| 7 |
+
"bias": "none",
|
| 8 |
+
"corda_config": null,
|
| 9 |
+
"ensure_weight_tying": false,
|
| 10 |
+
"eva_config": null,
|
| 11 |
+
"exclude_modules": null,
|
| 12 |
+
"fan_in_fan_out": false,
|
| 13 |
+
"inference_mode": true,
|
| 14 |
+
"init_lora_weights": true,
|
| 15 |
+
"layer_replication": null,
|
| 16 |
+
"layers_pattern": null,
|
| 17 |
+
"layers_to_transform": null,
|
| 18 |
+
"loftq_config": {},
|
| 19 |
+
"lora_alpha": 128,
|
| 20 |
+
"lora_bias": false,
|
| 21 |
+
"lora_dropout": 0.05,
|
| 22 |
+
"lora_ga_config": null,
|
| 23 |
+
"megatron_config": null,
|
| 24 |
+
"megatron_core": "megatron.core",
|
| 25 |
+
"modules_to_save": null,
|
| 26 |
+
"peft_type": "LORA",
|
| 27 |
+
"peft_version": "0.19.1",
|
| 28 |
+
"qalora_group_size": 16,
|
| 29 |
+
"r": 64,
|
| 30 |
+
"rank_pattern": {},
|
| 31 |
+
"revision": "0c351dd01ed87e9c1b53cbc748cba10e6187ff3b",
|
| 32 |
+
"target_modules": [
|
| 33 |
+
"o_proj",
|
| 34 |
+
"k_proj",
|
| 35 |
+
"up_proj",
|
| 36 |
+
"gate_proj",
|
| 37 |
+
"q_proj",
|
| 38 |
+
"v_proj",
|
| 39 |
+
"down_proj"
|
| 40 |
+
],
|
| 41 |
+
"target_parameters": null,
|
| 42 |
+
"task_type": "CAUSAL_LM",
|
| 43 |
+
"trainable_token_indices": null,
|
| 44 |
+
"use_bdlora": null,
|
| 45 |
+
"use_dora": false,
|
| 46 |
+
"use_qalora": false,
|
| 47 |
+
"use_rslora": false
|
| 48 |
+
}
|
adapter_model.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:37dbcf5e4db0b20d9c90dc42170f33143a5f5c3c4c413ca7878774737bb79cb9
|
| 3 |
+
size 349251816
|
selection_head.pt
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:31d5b513154c74d88d8af50ddf35a4876ac55b7e7295f2508b68067fd68a10b7
|
| 3 |
+
size 2458
|