| import base64 |
| import json |
| from datetime import datetime |
| import gradio as gr |
| import torch |
| import spaces |
| from PIL import Image, ImageDraw |
| from qwen_vl_utils import process_vision_info |
| from transformers import Qwen2VLForConditionalGeneration, AutoProcessor |
| import ast |
| import os |
| import numpy as np |
| from huggingface_hub import hf_hub_download, list_repo_files |
|
|
| |
| DESCRIPTION = "[ShowUI Demo](https://huggingface.co/showlab/ShowUI-2B)" |
| _SYSTEM = "Based on the screenshot of the page, I give a text description and you give its corresponding location. The coordinate represents a clickable location [x, y] for an element, which is a relative coordinate on the screenshot, scaled from 0 to 1." |
| MIN_PIXELS = 256 * 28 * 28 |
| MAX_PIXELS = 1344 * 28 * 28 |
|
|
| |
| model_repo = "showlab/ShowUI-2B" |
| destination_folder = "./showui-2b" |
|
|
| |
| os.makedirs(destination_folder, exist_ok=True) |
|
|
| |
| files = list_repo_files(repo_id=model_repo) |
|
|
| |
| for file in files: |
| file_path = hf_hub_download(repo_id=model_repo, filename=file, local_dir=destination_folder) |
| print(f"Downloaded {file} to {file_path}") |
|
|
| model = Qwen2VLForConditionalGeneration.from_pretrained( |
| destination_folder, |
| torch_dtype=torch.bfloat16, |
| device_map="cpu", |
| ) |
|
|
| |
| processor = AutoProcessor.from_pretrained("Qwen/Qwen2-VL-2B-Instruct", min_pixels=MIN_PIXELS, max_pixels=MAX_PIXELS) |
|
|
| |
| def draw_point(image_input, point=None, radius=5): |
| """Draw a point on the image.""" |
| if isinstance(image_input, str): |
| image = Image.open(image_input) |
| else: |
| image = Image.fromarray(np.uint8(image_input)) |
|
|
| if point: |
| x, y = point[0] * image.width, point[1] * image.height |
| ImageDraw.Draw(image).ellipse((x - radius, y - radius, x + radius, y + radius), fill='red') |
| return image |
|
|
| def array_to_image_path(image_array, session_id): |
| """Save the uploaded image and return its path.""" |
| if image_array is None: |
| raise ValueError("No image provided. Please upload an image before submitting.") |
| img = Image.fromarray(np.uint8(image_array)) |
| filename = f"{session_id}.png" |
| img.save(filename) |
| return os.path.abspath(filename) |
|
|
| def crop_image(image_path, click_xy, crop_factor=0.5): |
| """Crop the image around the click point.""" |
| image = Image.open(image_path) |
| width, height = image.size |
| crop_width, crop_height = int(width * crop_factor), int(height * crop_factor) |
|
|
| center_x, center_y = int(click_xy[0] * width), int(click_xy[1] * height) |
| left = max(center_x - crop_width // 2, 0) |
| upper = max(center_y - crop_height // 2, 0) |
| right = min(center_x + crop_width // 2, width) |
| lower = min(center_y + crop_height // 2, height) |
|
|
| cropped_image = image.crop((left, upper, right, lower)) |
| cropped_image_path = f"cropped_{os.path.basename(image_path)}" |
| cropped_image.save(cropped_image_path) |
|
|
| return cropped_image_path |
|
|
| @spaces.GPU |
| def run_showui(image, query, session_id, iterations=2): |
| """Main function for iterative inference.""" |
| image_path = array_to_image_path(image, session_id) |
| |
| click_xy = None |
| images_during_iterations = [] |
|
|
| for _ in range(iterations): |
| messages = [ |
| { |
| "role": "user", |
| "content": [ |
| {"type": "text", "text": _SYSTEM}, |
| {"type": "image", "image": image_path, "min_pixels": MIN_PIXELS, "max_pixels": MAX_PIXELS}, |
| {"type": "text", "text": query} |
| ], |
| } |
| ] |
|
|
| global model |
| model = model.to("cuda") |
|
|
| 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" |
| ) |
| inputs = inputs.to("cuda") |
|
|
| generated_ids = model.generate(**inputs, max_new_tokens=128) |
| generated_ids_trimmed = [ |
| out_ids[len(in_ids):] for in_ids, out_ids in zip(inputs.input_ids, generated_ids) |
| ] |
| output_text = processor.batch_decode( |
| generated_ids_trimmed, skip_special_tokens=True, clean_up_tokenization_spaces=False |
| )[0] |
|
|
| click_xy = ast.literal_eval(output_text) |
|
|
| |
| result_image = draw_point(image_path, click_xy, radius=10) |
| images_during_iterations.append(result_image) |
|
|
| |
| image_path = crop_image(image_path, click_xy) |
|
|
| return images_during_iterations, str(click_xy) |
|
|
| def save_and_upload_data(image, query, session_id, is_example_image, votes=None): |
| """Save the data to a JSON file and upload to S3.""" |
| if is_example_image == "True": |
| return |
|
|
| votes = votes or {"upvotes": 0, "downvotes": 0} |
|
|
| |
| image_file_name = f"{session_id}.png" |
| image.save(image_file_name) |
|
|
| data = { |
| "image_path": image_file_name, |
| "query": query, |
| "votes": votes, |
| "timestamp": datetime.now().isoformat() |
| } |
| |
| local_file_name = f"{session_id}.json" |
| |
| with open(local_file_name, "w") as f: |
| json.dump(data, f) |
|
|
| return data |
|
|
| def update_vote(vote_type, session_id, is_example_image): |
| """Update the vote count and re-upload the JSON file.""" |
| if is_example_image == "True": |
| return "Example image." |
|
|
| local_file_name = f"{session_id}.json" |
| |
| with open(local_file_name, "r") as f: |
| data = json.load(f) |
| |
| if vote_type == "upvote": |
| data["votes"]["upvotes"] += 1 |
| elif vote_type == "downvote": |
| data["votes"]["downvotes"] += 1 |
| |
| with open(local_file_name, "w") as f: |
| json.dump(data, f) |
|
|
| return f"Thank you for your {vote_type}!" |
|
|
| with open("./assets/showui.png", "rb") as image_file: |
| base64_image = base64.b64encode(image_file.read()).decode("utf-8") |
|
|
| examples = [ |
| ["./examples/app_store.png", "Download Kindle.", True], |
| ["./examples/ios_setting.png", "Turn off Do not disturb.", True], |
| |
| |
| |
| |
| |
| |
| |
| ] |
|
|
| def build_demo(embed_mode, concurrency_count=1): |
| with gr.Blocks(title="ShowUI Demo", theme=gr.themes.Default()) as demo: |
| state_image_path = gr.State(value=None) |
| state_session_id = gr.State(value=None) |
|
|
| if not embed_mode: |
| gr.HTML( |
| f""" |
| <div style="text-align: center; margin-bottom: 20px;"> |
| <div style="display: flex; justify-content: center;"> |
| <img src="data:image/png;base64,{base64_image}" alt="ShowUI" width="320" style="margin-bottom: 10px;"/> |
| </div> |
| <p>ShowUI is a lightweight vision-language-action model for GUI agents.</p> |
| <div style="display: flex; justify-content: center; gap: 15px; font-size: 20px;"> |
| <a href="https://huggingface.co/showlab/ShowUI-2B" target="_blank"> |
| <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-ShowUI--2B-blue" alt="model"/> |
| </a> |
| <a href="https://arxiv.org/abs/2411.17465" target="_blank"> |
| <img src="https://img.shields.io/badge/arXiv%20paper-2411.17465-b31b1b.svg" alt="arXiv"/> |
| </a> |
| <a href="https://github.com/showlab/ShowUI" target="_blank"> |
| <img src="https://img.shields.io/badge/GitHub-ShowUI-black" alt="GitHub"/> |
| </a> |
| </div> |
| </div> |
| """ |
| ) |
|
|
| with gr.Row(): |
| with gr.Column(scale=3): |
| imagebox = gr.Image(type="numpy", label="Input Screenshot", placeholder="""#Try ShowUI with screenshots! |
| |
| |
| Windows: [Win + Shift + S] |
| macOS: [Command + Shift + 3] |
| |
| Then upload/paste from clipboard 🤗 |
| """) |
| |
| |
| iteration_slider = gr.Slider(minimum=1, maximum=3, step=1, value=1, label="Refinement Steps") |
|
|
| textbox = gr.Textbox( |
| show_label=True, |
| placeholder="Enter a query (e.g., 'Click Nahant')", |
| label="Query", |
| ) |
| submit_btn = gr.Button(value="Submit", variant="primary") |
|
|
| |
| gr.Examples( |
| examples=[[e[0], e[1]] for e in examples], |
| inputs=[imagebox, textbox], |
| outputs=[textbox], |
| examples_per_page=3, |
| ) |
|
|
| |
| is_example_dropdown = gr.Dropdown( |
| choices=["True", "False"], |
| value="False", |
| visible=False, |
| label="Is Example Image", |
| ) |
|
|
| def set_is_example(query): |
| |
| for _, example_query, is_example in examples: |
| if query.strip() == example_query.strip(): |
| return str(is_example) |
| return "False" |
|
|
| textbox.change( |
| set_is_example, |
| inputs=[textbox], |
| outputs=[is_example_dropdown], |
| ) |
|
|
| with gr.Column(scale=8): |
| output_gallery = gr.Gallery(label="Iterative Refinement", object_fit="contain", preview=True) |
| |
| gr.HTML( |
| """ |
| <p><strong>Note:</strong> The <span style="color: red;">red point</span> on the output image represents the predicted clickable coordinates.</p> |
| """ |
| ) |
| output_coords = gr.Textbox(label="Final Clickable Coordinates") |
|
|
| gr.HTML( |
| """ |
| <p><strong>🤔 Good or bad? Rate your experience to help us improve! ⬇️</strong></p> |
| """ |
| ) |
| with gr.Row(elem_id="action-buttons", equal_height=True): |
| upvote_btn = gr.Button(value="👍 Looks good!", variant="secondary") |
| downvote_btn = gr.Button(value="👎 Too bad!", variant="secondary") |
| clear_btn = gr.Button(value="🗑️ Clear", interactive=True) |
|
|
| def on_submit(image, query, iterations, is_example_image): |
| if image is None: |
| raise ValueError("No image provided. Please upload an image before submitting.") |
| |
| session_id = datetime.now().strftime("%Y%m%d_%H%M%S") |
| |
| images_during_iterations, click_coords = run_showui(image, query, session_id, iterations) |
| |
| save_and_upload_data(images_during_iterations[0], query, session_id, is_example_image) |
| |
| return images_during_iterations, click_coords, session_id |
|
|
| submit_btn.click( |
| on_submit, |
| [imagebox, textbox, iteration_slider, is_example_dropdown], |
| [output_gallery, output_coords, state_session_id], |
| ) |
|
|
| clear_btn.click( |
| lambda: (None, None, None, None), |
| inputs=None, |
| outputs=[imagebox, textbox, output_gallery, output_coords, state_session_id], |
| queue=False |
| ) |
|
|
| upvote_btn.click( |
| lambda session_id, is_example_image: update_vote("upvote", session_id, is_example_image), |
| inputs=[state_session_id, is_example_dropdown], |
| outputs=[], |
| queue=False |
| ) |
|
|
| downvote_btn.click( |
| lambda session_id, is_example_image: update_vote("downvote", session_id, is_example_image), |
| inputs=[state_session_id, is_example_dropdown], |
| outputs=[], |
| queue=False |
| ) |
|
|
| return demo |
|
|
| if __name__ == "__main__": |
| demo = build_demo(embed_mode=False) |
| demo.queue(api_open=False).launch( |
| server_name="0.0.0.0", |
| server_port=7860, |
| ssr_mode=False, |
| debug=True, |
| ) |