{"about":{"non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","site":"https://codewithpapers.app","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page","syntology":{"site":"https://syntology.ai","developers":"https://syntology.ai/developers","mcp":{"server":"https://syntology.ai/mcp","transport":"streamable-http","server_card":"https://syntology.ai/.well-known/mcp/server-card.json","auth":{"type":"trial token, no account","trial_token":"https://syntology.ai/api/oauth/trial/token","method":"POST","docs":"https://syntology.ai/developers"}},"have":"https://syntology.ai/api/graph/have?x=<method, arXiv id or title> (free, answers coverage only)","paper_base":"https://syntology.ai/paper/","atlas_base":"https://app.syntology.ai/?focus="},"machine_readable":[{"url":"https://codewithpapers.app/llms.txt","what":"the machine catalog: every machine-readable file, counted"},{"url":"https://codewithpapers.app/index/manifest.json","what":"paper-to-code index by arXiv id, with Syntology's counts"},{"url":"https://codewithpapers.app/search/manifest.json","what":"site search index (titles, authors) and its files"},{"url":"https://codewithpapers.app/download","what":"bulk files: Syntology's layer, described there"},{"url":"https://codewithpapers.app/build_manifest.json","what":"the build record: inputs, counts, exclusions, probes"}]},"url":"/paper/ui-r1-enhancing-action-prediction-of-gui","title":"UI-R1: Enhancing Efficient Action Prediction of GUI Agents by Reinforcement Learning","arxiv_id":"2503.21620","date":"2025-03-27","proceeding":null,"authors":["Zhengxi Lu","Yuxiang Chai","Yaxuan Guo","Xi Yin","Liang Liu","Hao Wang","Han Xiao","Shuai Ren","Guanjing Xiong","Hongsheng Li"],"abstract":"The recent DeepSeek-R1 has showcased the emergence of reasoning capabilities in LLMs through reinforcement learning (RL) with rule-based rewards. Despite its success in language models, its application in multi-modal domains, particularly in graphic user interface (GUI) agent tasks, remains under-explored. To address this issue, we propose UI-R1, the first framework to explore how rule-based RL can enhance the reasoning capabilities of multimodal large language models (MLLMs) for GUI action prediction tasks. Specifically, UI-R1 introduces a novel rule-based action reward, enabling model optimization via policy-based algorithms such as Group Relative Policy Optimization (GRPO). For efficient training, we curate a small yet high-quality dataset of 136 challenging tasks, encompassing five common action types on mobile devices. Experimental results demonstrate that our proposed UI-R1-3B achieves significant improvements over the base model (i.e. Qwen2.5-VL-3B) on both in-domain (ID) and out-of-domain (OOD) tasks, with average accuracy gains of 22.1% on ScreenSpot, 6.0% on ScreenSpot-Pro, and 12.7% on ANDROIDCONTROL. Furthermore, UI-R1-3B delivers competitive performance compared to larger models (e.g., OS-Atlas-7B) trained via supervised fine-tuning (SFT) on 76K samples. We additionally develop an optimized version, UI-R1-E-3B, which significantly improves both grounding efficiency and accuracy. These results underscore the potential of rule-based reinforcement learning to advance GUI understanding and control, paving the way for future research in this domain. Code website: https://github.com/lll6gg/UI-R1.","url_abs":"https://arxiv.org/abs/2503.21620v4","url_pdf":"https://arxiv.org/pdf/2503.21620v4.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"ui-r1-enhancing-action-prediction-of-gui","repo_url":"https://github.com/lll6gg/ui-r1","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"Apache-2.0"}}],"tasks":[{"task_slug":"model-optimization","task_name":"Model Optimization"},{"task_slug":"reinforcement-learning-1","task_name":"Reinforcement Learning (RL)"}],"methods":[{"method_slug":"base","method_name":"BASE"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2503.21620","atlas_url":"https://app.syntology.ai/?focus=2503.21620","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2503.21620"},"calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2503.21620"},"returns":"the samples harvested from this paper, each with its run record; it does not verify the paper"},{"tool":"get_code","arguments_in":"samples[].code_sha256","returns":"one stored sample by its code_sha256; not shown on this site"}]},"developers":"https://syntology.ai/developers","held":true,"reason":"in_graph_layer","checked_against":null,"agent_calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2503.21620"},"call":"get_harvested_code_for_paper(arxiv_id=\"2503.21620\")"},{"tool":"get_code","arguments_in":{"code_sha256":"syntology.samples[].code_sha256"},"call":"get_code(code_sha256=\"…\")"},{"tool":"get_citation_path","arguments":{"paper_1":"2503.21620"},"arguments_in":{"paper_2":"another paper's arXiv id or title"},"call":"get_citation_path(paper_1=\"2503.21620\", paper_2=\"…\")"},{"tool":"get_concepts_for_paper","arguments":{"arxiv_id":"2503.21620"},"call":"get_concepts_for_paper(arxiv_id=\"2503.21620\")"}],"by_repo":[{"repo":"lll6gg/ui-r1","kind":"official","samples":12,"ran":10,"instrument":3,"unverified":2}],"by_repo_is":"one row per repository in the archive's code links, Syntology's graph links or the samples; samples 0 means no sample is linked to this paper, a statement about Syntology's coverage, not about the repository: with harvested_for_other_papers present, Syntology harvested the repository for that many other papers, and without it, Syntology harvested nothing from it; placed_by_identical_code counts samples whose link records no repository, placed here because identical code was harvested from this repository for another paper; ran counts executions on a synthesized input and instrument counts failures of Syntology's instrument, not of the code","read_at":"2026-10-05T00:36:11+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","ran_record":{"url":"https://syntology.ai/api/ran/2503.21620.json","schema":"syntology.ran_record/1","counts_crosswalk":{"n_samples":"syntology.counts.lifted","n_ran":"syntology.counts.executed","n_ran_checked":"syntology.counts.checked","n_instrument":"syntology.counts.instrument_failures","n_unverified":"syntology.counts.no_recorded_run"},"note":"live record, measured at request time; may be newer than this page's graph read","badge":"https://syntology.ai/api/ran/2503.21620.svg"},"claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/lll6gg/ui-r1","reach":{"status":"ok","spdx":"Apache-2.0"}}],"summary":{"ran":6,"ran_draft_wrong":2,"ran_fixture":1,"ran_honours":1,"unverified":2},"n_samples":12,"n_ran":10,"n_constructed":0,"n_ran_checked":7,"n_instrument":3,"n_unverified":2,"n_instrument_is":"failures of Syntology's instrument, not of the code","every_run_is_an_instrument_failure":false,"key_notes":{"n_ran_checked":"legacy name, kept unchanged so existing readers do not break: it counts the samples that ran with no instrument failure (honoured, violated, and ran with no contract checked); it does not mean a contract was checked, and the pages print it as 'K with no instrument failure', not 'K checked'","n_constructed":"a sub-count of the samples that ran, never subtracted from them and never a failure: an executed sample whose run returned an instance of its own class (fixture_out_type equals the entry name): the run built an object and did not compute a result (Syntology's RAN record, counts.constructed)"},"by_repo_kind":{"official":{"samples":12,"ran":10,"n_ran_checked":7,"n_instrument":3,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":3,"inline_ok_is":"inline_ok is true only when both licence gates allow Syntology to serve this code's text: this paper's link (inline_ok_link, from the licence of this paper's copy) and the stored copy of the same code that Syntology serves, which may have been first harvested from another repository. withheld_clause is Syntology's own wording of which gate keeps the text a pointer and why, and is null when inline_ok is true. This site shows no code text either way; n_pointer_only_for_licence counts samples with inline_ok false (both gates), n_pointer_only_link_allows those of them whose inline_ok_link is true","n_pointer_only_link_allows":3,"fixture_fields_is":{"signature_and_fixture_out_type":"the arguments Syntology's fixture called the sample with, each as name:type/rank/element kind (? where none was recorded), and the type of what the fixture's run returned, exactly as the harness recorded them; the arguments and the returned type were recorded by two separate runs of the same fixture. No output value is shown, and a returned type says nothing about whether the output was right","level_recorded_at":"when Syntology's graph wrote the sample's verification level, not when the code executed; absent where the level was written before the date was kept, and never filled in with the build date","present_on":"samples that ran only; a key is absent, never empty, where the graph records nothing"},"n_ran_with_level_date":9,"n_ran_without_level_date":1,"n_ran_signature_not_shown":0,"levels_written_between":{"first":"2026-09-24","last":"2026-09-26","is":"the first and last UTC dates on which Syntology's graph wrote a verification level for a sample on this page that ran, not when the code executed"},"code_page_min_papers":5,"code_page_is":"a page for the entry name across every paper's harvested code; the name is a string, not an identity","samples":[{"code_sha256":"0973f0f093e870b6","code_sha256_prefix":"0973f0f093e870b6","entry":"extract_action","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/src/open_r1/grpo_json_action_coord-dast.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/src/open_r1/grpo_json_action_coord-dast.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"response:str/0/str","fixture_out_type":"str","level_recorded_at":"2026-09-25T00:28:05.031210+00:00","retrieve_with":{"tool":"get_code","code_sha256":"0973f0f093e870b6"},"code_page":"/code/extract-action","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"0973f0f093e870b6"}},{"code_sha256":"d73a25686eea74ad","code_sha256_prefix":"d73a25686eea74ad","entry":"extract_bbox","repo":"lll6gg/ui-r1","repo_kind":"official","path":"evaluation/eval_ss_pro.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/evaluation/eval_ss_pro.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"content:str/0/str","fixture_out_type":"list","level_recorded_at":"2026-09-24T23:57:41.519889+00:00","retrieve_with":{"tool":"get_code","code_sha256":"d73a25686eea74ad"},"code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"d73a25686eea74ad"}},{"code_sha256":"035f888a03e23312","code_sha256_prefix":"035f888a03e23312","entry":"extract_bbox","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/src/open_r1/grpo_json_action_coord-dast.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/src/open_r1/grpo_json_action_coord-dast.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"response:str/0/str","fixture_out_type":"tuple","level_recorded_at":"2026-09-25T00:28:05.031210+00:00","retrieve_with":{"tool":"get_code","code_sha256":"035f888a03e23312"},"code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"035f888a03e23312"}},{"code_sha256":"65a33c4833de06e2","code_sha256_prefix":"65a33c4833de06e2","entry":"extract_coord","repo":"lll6gg/ui-r1","repo_kind":"official","path":"evaluation/eval_ss_pro.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/evaluation/eval_ss_pro.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"content:str/0/str","fixture_out_type":"list","level_recorded_at":"2026-09-25T00:28:05.031210+00:00","retrieve_with":{"tool":"get_code","code_sha256":"65a33c4833de06e2"},"code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"65a33c4833de06e2"}},{"code_sha256":"fd4b791e36daf2e0","code_sha256_prefix":"fd4b791e36daf2e0","entry":"extract_coord","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/src/open_r1/grpo_json_action_coord-dast.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/src/open_r1/grpo_json_action_coord-dast.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"content:str/0/str","fixture_out_type":"tuple","level_recorded_at":"2026-09-24T23:57:41.519889+00:00","retrieve_with":{"tool":"get_code","code_sha256":"fd4b791e36daf2e0"},"code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"fd4b791e36daf2e0"}},{"code_sha256":"41c548a25e90eb39","code_sha256_prefix":"41c548a25e90eb39","entry":"extract_problem_solution","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/local_scripts/prepare_hf_data.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/local_scripts/prepare_hf_data.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"gpt4o_response:str/0/str","fixture_out_type":"tuple","level_recorded_at":"2026-09-26T03:58:20.443611+00:00","retrieve_with":{"tool":"get_code","code_sha256":"41c548a25e90eb39"},"code_page":"/code/extract-problem-solution","census":null,"licence":"Apache-2.0","inline_ok":false,"inline_ok_link":true,"withheld_clause":"this paper's link allows the body inline (Apache-2.0), but get_code serves the stored copy, first harvested from AMAP-ML/Q-Hawkeye, and GitHub detected no licence in that repository when it was checked","mcp_get_code":{"code_sha256":"41c548a25e90eb39"}},{"code_sha256":"3f31b48fd862935d","code_sha256_prefix":"3f31b48fd862935d","entry":"get_image_data_url","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/local_scripts/create_vision_cot_data.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/local_scripts/create_vision_cot_data.py","link_basis":"harvester_set","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"signature":"image_input:Image/0/?","fixture_out_type":"str","code_page":"/code/get-image-data-url","census":null,"licence":"Apache-2.0","inline_ok":false,"inline_ok_link":true,"withheld_clause":"this paper's link allows the body inline (Apache-2.0), but get_code serves the stored copy, first harvested from minglllli/cls-rl, and GitHub detected no licence in that repository when it was checked","mcp_get_code":{"code_sha256":"3f31b48fd862935d"}},{"code_sha256":"3a64cfbe91e08c2e","code_sha256_prefix":"3a64cfbe91e08c2e","entry":"process_ref_dir","repo":"lll6gg/ui-r1","repo_kind":"official","path":"evaluation/eval_ss_pro.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/evaluation/eval_ss_pro.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"ref_dir:str/0/str","fixture_out_type":"tuple","level_recorded_at":"2026-09-25T00:28:05.031210+00:00","code_page":null,"census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"3a64cfbe91e08c2e"}},{"code_sha256":"f029d6b5f19d2885","code_sha256_prefix":"f029d6b5f19d2885","entry":"process_single_item","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/local_scripts/create_vision_cot_data.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/local_scripts/create_vision_cot_data.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"example:dict/0/?","fixture_out_type":"dict","level_recorded_at":"2026-09-26T01:55:17.694675+00:00","code_page":"/code/process-single-item","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"f029d6b5f19d2885"}},{"code_sha256":"a50444314d796645","code_sha256_prefix":"a50444314d796645","entry":"smart_resize","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/src/open_r1/trainer/DAST_grpo_trainer.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/src/open_r1/trainer/DAST_grpo_trainer.py","link_basis":"harvester_set","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"height:int/0/int, width:int/0/int, factor:int/0/int, min_pixels:int/0/int, max_pixels:int/0/int","fixture_out_type":"tuple","level_recorded_at":"2026-09-25T15:11:32.249708+00:00","code_page":"/code/smart-resize","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"a50444314d796645"}},{"code_sha256":"58ab41ce28a94c62","code_sha256_prefix":"58ab41ce28a94c62","entry":"gpt4o_query","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/local_scripts/create_vision_cot_data.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/local_scripts/create_vision_cot_data.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":"/code/gpt4o-query","census":null,"licence":"Apache-2.0","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"58ab41ce28a94c62"}},{"code_sha256":"bdcc94560fb87f30","code_sha256_prefix":"bdcc94560fb87f30","entry":"load_image_from_path","repo":"lll6gg/ui-r1","repo_kind":"official","path":"src/ui_r1/local_scripts/prepare_hf_data.py","file_url":"https://github.com/lll6gg/ui-r1/blob/HEAD/src/ui_r1/local_scripts/prepare_hf_data.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":"/code/load-image-from-path","census":null,"licence":"Apache-2.0","inline_ok":false,"inline_ok_link":true,"withheld_clause":"this paper's link allows the body inline (Apache-2.0), but get_code serves the stored copy, first harvested from AMAP-ML/Q-Hawkeye, and GitHub detected no licence in that repository when it was checked","mcp_get_code":{"code_sha256":"bdcc94560fb87f30"}}]},"code_links_note":null,"arxiv_metadata":null,"syntology_extracted_results":null,"record_sha256":"a298550429a5f4d944088cb893576afdda613c51992e322d661eda078a6ec1c3","record_changed_at":"2026-10-04","record_changed_at_basis":"changed"}