Qwen-CUA

<div align="center"> <img src="https://raw.githubusercontent.com/xlang-ai/Qwen-CUA/main/assets/readme/qwen-cua-mascot.png" width="156" alt="Qwen-CUA mascot holding a mouse pointer and keyboard"> <h1>Qwen-CUA: Native Computer Use for (almost) Everything</h1> <p> A Qwen-based computer-use model that sees screenshots, reasons over visible state,<br> and acts through native keyboard and mouse events. </p> <p> <a href="https://arxiv.org/abs/2608.02352"><img alt="arXiv" src="https://img.shields.io/badge/arXiv-2608.02352-B31B1B?style=flat-square"></a> <a href="https://github.com/xlang-ai/Qwen-CUA"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-Qwen--CUA-181717?style=flat-square&logo=github"></a> <a href="https://github.com/xlang-ai/Qwen-CUA/tree/main/demo"><img alt="Demo" src="https://img.shields.io/badge/Demo-Run%20locally-3A8D7C?style=flat-square"></a> <a href="https://huggingface.co/xlangai/Qwen-CUA/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-4B5563?style=flat-square"></a> </p> </div> <p align="center"> <a href="https://arxiv.org/abs/2608.02352"> <img src="https://raw.githubusercontent.com/xlang-ai/Qwen-CUA/main/assets/readme/main-results.png" width="100%" alt="Qwen-CUA results across eight computer-use benchmarks"> </a> </p>

Model overview

Qwen-CUA is a native computer-use model from the Qwen Team and XLang Lab. It operates from pixels: the model receives screenshots and natural-language instructions, reasons about the visible interface, and emits grounded keyboard and mouse actions. The evaluation setup does not provide DOM trees, accessibility metadata, shell access, or task-specific APIs.

The checkpoint is only one part of a computer-use agent. A complete deployment must also capture screenshots, build multimodal history, parse and validate actions, execute them in an environment, gate sensitive actions, and verify outcomes. The reference demo provides this surrounding runtime for browser workflows.

Computer-use protocol

The model is prompted with a computer_use function and returns actions as XML. Coordinates use a normalized 0..999 grid, independent of the actual screenshot resolution. A typical action is:

<tool_call>
<function=computer_use>
<parameter=action>
left_click
</parameter>
<parameter=coordinate>
[500, 420]
</parameter>
</function>
</tool_call>

The reference runtime supports key presses, key down/up, typing, mouse movement, left/right/middle clicks, double/triple clicks, drag, vertical/horizontal scrolling, screenshots, waiting, asking the user, and terminating with success or failure. It validates every parsed action before execution.

The paper's agent scaffold keeps the 20 most recent screenshots active. Older screenshots are folded in blocks of 10 into a fixed textual placeholder while reasoning and action history are retained. This bounds image-heavy context growth and preserves a stable prefix for KV-cache reuse. Context folding is runtime behavior and is not performed automatically by the checkpoint or inference server.

Serving

This is a very large checkpoint. The examples below use tensor parallelism across eight high-memory GPUs. The roughly 807 GB of BF16 weights require enough aggregate accelerator memory for the weights plus KV cache and runtime buffers; H200 141 GB-class GPUs are an appropriate reference configuration. Reducing the context length reduces KV-cache use but does not reduce model-weight memory.

Qwen-CUA uses the public qwen3_5_moe architecture. Use current development/nightly builds of the serving frameworks; older releases may report that this model type is unknown.

SGLang

Install the current SGLang source build:

uv pip install 'git+https://github.com/sgl-project/sglang.git#subdirectory=python&egg=sglang[all]'

Launch an OpenAI-compatible endpoint:

python -m sglang.launch_server \
  --model-path xlangai/Qwen-CUA \
  --host 0.0.0.0 \
  --port 8000 \
  --tp-size 8 \
  --mem-fraction-static 0.8 \
  --context-length 262144 \
  --reasoning-parser qwen3 \
  --trust-remote-code

vLLM

Install a current vLLM nightly build:

uv pip install vllm --torch-backend=auto \
  --extra-index-url https://wheels.vllm.ai/nightly

Launch the endpoint:

vllm serve xlangai/Qwen-CUA \
  --host 0.0.0.0 \
  --port 8000 \
  --tensor-parallel-size 8 \
  --max-model-len 262144 \
  --reasoning-parser qwen3 \
  --trust-remote-code

The reference agent supplies the computer_use schema in the prompt and parses the raw XML response itself. Do not enable a standard tool-call parser when connecting that demo. The qwen3 reasoning parser only separates reasoning from the final response.

Reference browser agent

The Qwen-CUA demo is the recommended end-to-end starting point. It combines a FastAPI runner, a Next.js operator console, isolated Playwright Chromium sessions, typed action validation, approval gates, and replay artifacts.

After starting either OpenAI-compatible endpoint above:

git clone https://github.com/xlang-ai/Qwen-CUA.git
cd Qwen-CUA/demo

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
python -m playwright install chromium

corepack enable
corepack prepare [email protected] --activate
pnpm install
cp .env.example .env

Set these values in .env:

QWEN_CUA_BASE_URL=http://127.0.0.1:8000/v1
QWEN_CUA_API_KEY=dummy
QWEN_CUA_MODELS=xlangai/Qwen-CUA
QWEN_CUA_DEFAULT_MODEL=xlangai/Qwen-CUA

QWEN_CUA_ENABLE_THINKING=true
QWEN_CUA_MAX_TOKENS=32768
QWEN_CUA_TEMPERATURE=0.6
QWEN_CUA_TOP_P=0.95
QWEN_CUA_TOP_K=20
QWEN_CUA_IMAGE_MAX=20
QWEN_CUA_VIEWPORT_WIDTH=1920
QWEN_CUA_VIEWPORT_HEIGHT=1080

Then start the runner and console:

set -a
source .env
set +a
pnpm dev

Open http://127.0.0.1:3000, select a safe local lab, and start a run. The first demo release targets browser workflows in Chromium rather than unrestricted Linux, Windows, or macOS desktop control. See the demo documentation for Docker, CLI, replay, and safety configuration.

Evaluation

The following results are reported in the Qwen-CUA technical report. They are system-level evaluations under each paper's agent scaffold, not isolated single-forward-pass checkpoint metrics. Reproduction depends on matching the observation loop, multimodal history construction, prompts, action execution, inference settings, environment, and benchmark versions described by the corresponding work.

For RedTeamCUA, task success measures utility and attack success rate (ASR) measures susceptibility to adversarial prompt injection, so lower ASR is better. The observed ASR does not constitute a deployment-safety guarantee.

Training overview

The development pipeline reported in the technical report combines iterative supervised fine-tuning (SFT) with reinforcement learning from verifiable rewards (RLVR):

• around 40,000 verifiable computer-use tasks covering broad software and personalized long-horizon workflows;
• large-scale rollout infrastructure with nearly 100,000 vCPUs and tens of thousands of concurrent environments;
• successive SFT runs that refresh the supervised mixture and recalibrate the RL task pool using current-policy rollouts;
• SAPO-based RL and long-horizon trajectory slicing to train efficiently from extended interaction traces.

The report's final RL setup uses 512 H200 GPUs across 64 nodes. Please refer to the technical report for the full training recipe and ablations. The model files alone do not encode every data, prompt, rollout, or runtime choice used during development.

Intended use

Qwen-CUA is intended for research and development of screenshot-grounded computer-use agents, including:

• controlled GUI-agent research and evaluation;
• browser automation in isolated, resettable environments;
• studies of visual grounding, long-horizon planning, recovery, and verification;
• development of action validation, approval, monitoring, and replay systems.

The model is not designed to serve as an autonomous authority for financial, medical, legal, security-critical, or other high-stakes decisions. Do not use it for unauthorized access, credential harvesting, covert surveillance, bypassing security controls, or destructive actions.

Safety and limitations

Computer-use models can misread screenshots, click the wrong target, enter incorrect text, mishandle state changes, or falsely claim success. Websites and documents may contain prompt injection intended to redirect the agent. Native pixel interaction also requires repeated inference and serialized low-level actions, which can be slower and more expensive than code, APIs, or shell tools when those interfaces are appropriate.

For safer evaluation and deployment:

• run in isolated, disposable browser or desktop environments;
• avoid authenticated accounts, secrets, private data, and high-stakes workflows;
• validate action schemas and coordinates before execution;
• require explicit human approval for submissions, downloads, uploads, credential entry, payments, cross-origin navigation, and other consequential operations;
• enforce network, filesystem, time, and action limits outside the model;
• retain screenshots, raw responses, actions, and verification evidence for audit and replay;
• independently verify the final environment state—a model's terminate(success) action is not proof of real-world success.

The reference browser demo implements several of these controls, but it is a local development system without authentication and does not eliminate prompt-injection or execution risk.

Citation

If you find Qwen-CUA useful in your work, please cite the technical report:

@misc{lu2026qwencuanativecomputeruse,
      title={Qwen-CUA: Native Computer Use for (almost) Everything},
      author={Dunjie Lu and Shuai Bai and Tianyi Bai and Sicheng Fan and Chang Gao and Jian Guan and Feng Hu and Mianqiu Huang and Xingyang Huang and Yizhen Jiang and Yuheng Jing and Dehui Kong and Ning Li and Dayiheng Liu and Shixuan Liu and Zheng Liu and Que Shen and Bowen Wang and Junli Wang and Chencan Wu and Rui Xie and Tianbao Xie and Zhihui Xie and Haiyang Xu and An Yang and Tao Yu and Wenzhen Yuan and Xi Zhang and Zhenru Zhang and Mingkang Zhu and Zhaoqing Zhu and Yizhong Cao and Kai Dang and Binyuan Hui and Kaixin Li and Junyang Lin and Haiquan Wang and Zekun Wang and Yiheng Xu and Fan Yan and Mengqi Yuan and Danyang Zhang and Jiajun Zhang and Zhipeng Zhang and Fan Zhou and Fan Zhou},
      year={2026},
      eprint={2608.02352},
      archivePrefix={arXiv},
      primaryClass={cs.LG},
      url={https://arxiv.org/abs/2608.02352},
}

License

Qwen-CUA is released under the Apache License 2.0. See the model repository's LICENSE and the source repository's NOTICE for attribution information.