Qwen2.5 VL 3B UI R1 E

🚀 高效GUI基础模型UI-R1-E-3B

本仓库包含高效的GUI基础模型 UI-R1-E-3B，该模型在论文 UI-R1: Enhancing Action Prediction of GUI Agents by Reinforcement Learning 中提出。此模型可用于视觉问答任务，基于基础模型 Qwen/Qwen2.5-VL-3B-Instruct 开发，采用MIT许可证。

项目页面：https://github.com/lll6gg/UI-R1

旧版本：UI-R1-3B

🚀 快速开始

本项目提供了高效的GUI基础模型UI-R1-E-3B，以下将从不同方面介绍该模型的相关信息，包括基准测试结果、评估代码等。

✨ 主要特性

• 高效的GUI基础模型：UI-R1-E-3B在多个基准测试中表现出色，为GUI代理的动作预测提供了强大的支持。
• 多场景适用性：在不同的设备类型（如移动设备、桌面设备、网页）和推理模式下都有良好的性能表现。

📚 详细文档

基准测试1：ScreenSpotV2

基准测试2：ScreenSpot-Pro

排行榜：UI-I2E-Bench

💻 使用示例

基础用法

UI-R1-E-3B生成代码

model = Qwen2_5_VLForConditionalGeneration.from_pretrained(
    args.model_path,
    torch_dtype=torch.bfloat16,
    attn_implementation="flash_attention_2",
    device_map="cpu",
)
model = model.to(torch.device(rank))
model = model.eval()
processor = AutoProcessor.from_pretrained(ori_processor_path)
question_template = (
    f"In this UI screenshot, I want to perform the command '{task_prompt}'.\n"
    "Please provide the action to perform (enumerate in ['click'])"
    "and the coordinate where the cursor is moved to(integer) if click is performed.\n"
    "Output the final answer in <answer> </answer> tags directly."
    "The output answer format should be as follows:\n"
    "<answer>[{'action': 'click', 'coordinate': [x, y]}]</answer>\n"
    "Please strictly follow the format."
)
query = '<image>\n' + question_template
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "image": image_path}
        ] + [{"type": "text", "text": query}],
    }
]
text = processor.apply_chat_template(
    messages, tokenize=False, add_generation_prompt=True
)
image_inputs, video_inputs = process_vision_info(messages)
inputs = processor(
    text=[text],
    images=image_inputs,
    videos=video_inputs,
    padding=True,
    return_tensors="pt",
)
generated_ids = model.generate(**inputs, max_new_tokens=1024)
generated_ids_trimmed = [
    out_ids[len(in_ids) :] for in_ids, out_ids in zip(inputs.input_ids, generated_ids)
]
response = processor.batch_decode(
    generated_ids_trimmed, skip_special_tokens=True, clean_up_tokenization_spaces=False
)
response = response[0]
pred_coord, _ = extract_coord(response)

根据图像调整预测坐标

image = Image.open(image_path)
origin_width, origin_height = image.size
resized_height,resized_width = smart_resize(origin_height,origin_width,max_pixels=12845056)
scale_x = origin_width / resized_width
scale_y = origin_height / resized_height
pred_coord[0] = int(pred_coord[0] * scale_x)
pred_coord[1] = int(pred_coord[1] * scale_y)

智能调整图像大小函数

import math
def smart_resize(
    height: int, width: int, factor: int = 28, min_pixels: int = 56 * 56, max_pixels: int = 14 * 14 * 4 * 1280
):
    """Rescales the image so that the following conditions are met:

    1. Both dimensions (height and width) are divisible by 'factor'.

    2. The total number of pixels is within the range ['min_pixels', 'max_pixels'].

    3. The aspect ratio of the image is maintained as closely as possible.

    """
    if height < factor or width < factor:
        raise ValueError(f"height:{height} or width:{width} must be larger than factor:{factor}")
    elif max(height, width) / min(height, width) > 200:
        raise ValueError(
            f"absolute aspect ratio must be smaller than 200, got {max(height, width) / min(height, width)}"
        )
    h_bar = round(height / factor) * factor
    w_bar = round(width / factor) * factor
    if h_bar * w_bar > max_pixels:
        beta = math.sqrt((height * width) / max_pixels)
        h_bar = math.floor(height / beta / factor) * factor
        w_bar = math.floor(width / beta / factor) * factor
    elif h_bar * w_bar < min_pixels:
        beta = math.sqrt(min_pixels / (height * width))
        h_bar = math.ceil(height * beta / factor) * factor
        w_bar = math.ceil(width * beta / factor) * factor
    return h_bar, w_bar

📄 许可证

本项目采用MIT许可证。