NorthCUA-Pro

beipo-ai/NorthCUA-Pro

作者
beipo-ai
任务
多模态
下载量
608
点赞数
32
趋势分
31
许可证
apache-2.0
收录时间
2026/11/7

license: apache-2.0 library_name: transformers pipeline_tag: image-text-to-text tags:

  • northcua
  • computer-use
  • multimodal
  • agents
  • qwen3_5_moe
  • safetensors

Computer-use agents trained through experience at scale

Model family · Performance · Training & report · Quickstart · Citation


Explore the NorthCUA model family

This is NorthCUA-Pro. Looking for another model size? Explore the other two members of our family:

NorthCUA-Nano — 9B total · 9B active · Dense

NorthCUA-Mini — 35B total · 3B active · MoE

Meet NorthCUA-Pro

NorthCUA-Pro is a 397B-parameter computer-use model with 17B active parameters, built on Qwen3.5. As the family's largest mixture-of-experts model, it takes user requests, screenshots, and interaction history and generates reasoning, responses, and tool calls for a desktop or browser runtime.

Required for computer use: Run NorthCUA with our official NorthCUA Harness. The model and Harness are designed to be used together for prompts, tool calls, observations, and action execution.

Strict coordinate contract — normalized_1000: All GUI action coordinates use the 0–1000 normalized coordinate space, not raw pixel coordinates. Keep this convention throughout the model–Harness interaction; the Harness converts coordinates to pixels at execution time.

NorthCUA connects sustained interaction, verified experience, and staged learning to carry tasks across changing software states—from understanding an instruction to producing and checking a result.

  • See and act. Visual grounding and multimodal observations support desktop applications and web workflows.
  • Learn from complete work. Long trajectories teach dependent steps, intermediate artifacts, and outcome verification.
  • Build on open weights. The Nano, Mini, and Pro family spans 9B / 35B / 397B total parameters, released under Apache-2.0.

Model family

ModelTotal parametersActive parametersArchitecture
NorthCUA-Nano9B9BDense
NorthCUA-Mini35B3BMixture of experts
NorthCUA-Pro397B17BMixture of experts

Nominal parameter counts follow the technical report. MoE active parameters describe computation per token, not the memory needed to load all weights.

Performance

Results reported in the NorthCUA technical report. Grounding uses SFT checkpoints; task completion uses subsequent joint desktop–web RL checkpoints. These research results have not been tied to an exact checkpoint975 export and are not new measurements of the files in this repository.

BenchmarkStage / metricNano · 9BMini · 35BPro · 397B
ScreenSpot-ProSFT · accuracy (%)72.8792.4193.30
OSWorld-GSFT · accuracy (%)82.9887.9490.96
OSWorld-VerifiedRL · success (%)78.9085.3088.64
WebArena-VerifiedRL · success (%)67.1670.4373.89

Sources: Table 6 and Tables 12–13 of the 121-page report. ScreenSpot-Pro uses 1,581 examples, one prediction per screenshot, and no iterative zoom/crop search. OSWorld-G uses 564 refined instructions and the best of three complete runs, not a mean or itemwise pass@3 (temperature 0.7, top-p 0.95, top-k 40, 1,024 output tokens, normalized 0–1000 coordinates).

ModelOSWorld SFTOSWorld RLWebArena SFTWebArena RL
Nano76.0578.9064.1667.16
Mini83.2985.3067.9870.43
Pro85.8788.6469.5873.89

OSWorld-Verified uses 361 tasks, excluding eight Google Drive tasks requiring separate account configuration. WebArena-Verified uses 812 tasks and official outcome checks. Both have a 100-step task limit. Retained-attempt selection and other protocol details are in §6.1 and Appendix I; compare results with those conditions in view.

The report also lists 66.80% mean partial credit for Pro after RL on OSWorld 2.0 (108 tasks, 500-step limit). This is not a full-completion rate; Nano and Mini results are unavailable in that table. The detailed WebTestBench table marks NorthCUA results as pending, so no score is asserted here.

Training and report

The NorthCUA experience loop — original Figure 2 from the technical report.

  1. Harness: a common runtime sustains desktop and web interaction, collects trajectories, and retains workspaces for outcome inspection. Visual context, compaction, and task memory support long workflows.
  2. Experience Flywheel: intents, environments, and verifiers become executable tasks. Assessed trajectories provide training experience; the report also proposes skill-guided and checkpoint-assisted collection for hard tasks.
  3. Staged Learning: broad GUI mid-training, verified long-horizon SFT, and joint desktop–web GRPO turn complementary experience into an improved policy.
Stage described in the reportExperience and scale
Broad GUI mid-trainingMore than 100,000 trajectories and 4 million interaction steps; approximately 40,000 grounding examples
Verified long-horizon SFTApproximately 3,000 verified trajectories and 310,000 GUI steps
Joint desktop–web RLA prepared pool of approximately 1,500 desktop tasks and 500 web tasks

These are rounded corpus/prepared-pool summaries from Table 3 and §5.1, not per-model consumption counts. The research pipeline contains multiple checkpoints and stages.

Figure 2 notes: GUI states, cursor cues, and rewards are schematic. Trajectory rows omit intermediate actions; GRPO retains valid failures alongside successes. The hard-task panel denotes the proposed skill-guided and checkpoint-assisted collection in §4.3. Reusing experience during training does not mean the serving model updates its weights while handling a request.

Quickstart

Required runtime and coordinate convention

Use these weights together with the official NorthCUA Harness for computer-use tasks. Follow its prompts, tool definitions, observation processing, and action execution rather than substituting an unrelated agent interface.

Coordinates are strictly normalized to 1000 on both axes: x and y each lie in [0, 1000], relative to the corresponding screenshot. For example, (500, 500) denotes the screenshot's center. This contract applies to every coordinate-bearing GUI action, including click targets and drag endpoints. Preserve normalized_1000 in model outputs and tool arguments, and let the official Harness perform the pixel conversion at the execution boundary. Do not pass these values directly as screen-pixel coordinates or mix coordinate systems between steps.

Download the weights

pip install -U huggingface_hub
hf download beipo-ai/NorthCUA-Pro --local-dir ./NorthCUA-Pro
cd NorthCUA-Pro
shasum -a 256 -c checksums.sha256

Pin a commit with --revision for reproducible use. The repository contains full Safetensors weights, configuration, tokenizer, image processor, and native chat template. The official NorthCUA Harness supplies the computer-use interaction loop and action execution and is required for the intended agent workflow.

Use PyTorch, Accelerate, Pillow, and a Transformers release that supports Qwen3_5MoeForConditionalGeneration. The export configuration records Transformers 5.20.2. The following is an illustrative loading and generation example for a machine with sufficient aggregate accelerator memory; it is not a benchmarked serving configuration.

import torch
from transformers import AutoProcessor, Qwen3_5MoeForConditionalGeneration

model_id = "beipo-ai/NorthCUA-Pro"
processor = AutoProcessor.from_pretrained(model_id)
model = Qwen3_5MoeForConditionalGeneration.from_pretrained(
    model_id, dtype=torch.bfloat16, device_map="auto"
)

messages = [{
    "role": "user",
    "content": [
        {"type": "image", "url": "/absolute/path/to/screenshot.png"},
        {"type": "text", "text": "Describe the visible interface and how to open its settings."},
    ],
}]
inputs = processor.apply_chat_template(
    messages,
    tokenize=True,
    add_generation_prompt=True,
    return_dict=True,
    return_tensors="pt",
).to(model.device)
with torch.inference_mode():
    output = model.generate(**inputs, max_new_tokens=512, do_sample=False)
new_tokens = output[0][inputs["input_ids"].shape[-1]:]
print(processor.decode(new_tokens, skip_special_tokens=True))

This standalone example demonstrates image-text generation only. For computer-use tasks, use the official NorthCUA Harness, which supplies the interaction loop, tool execution, and updated observations. Preserve native tool-call/result pairing and the strict normalized_1000 coordinate contract; pixel conversion belongs at the Harness execution boundary.

This releaseValue
ModelNorthCUA-Pro
Architecture familyQwen3.5-397B-A17B
Transformers classQwen3_5MoeForConditionalGeneration
Language-model layers60
FormatFull Safetensors weights; predominantly BF16
Weight shards122
Model files on diskApproximately 793.63 GB, before runtime caches
Configured context length262,144 tokens
Releaser13 post-training checkpoint 975
LicenseApache-2.0

The repository includes configuration, tokenizer, image processor, and native chat template. Use the official NorthCUA Harness for desktop or browser interaction, tool handling, and action execution. The configured context length is not a measured guarantee of task quality at that length. These exports do not include multi-token-prediction (MTP) weights.

The export records Transformers 5.20.2. Choose an engine that supports the architecture, vision processing, native chat template, and reasoning/tool-call format. The upstream Qwen3.5 guide is an architecture reference, not serving validation for these fine-tuned weights. Check text, image, multi-image, tool use, and streaming in your deployment. Allow additional memory for activations and KV caches; active-parameter counts are not weight-memory estimates.

checksums.sha256 covers its listed files. Documentation and image assets may evolve independently of the model weights.

Responsible use and limitations

NorthCUA is intended for research and development of computer-use agents. Verify consequential actions and final artifacts, isolate the execution environment, and protect credentials from observed content.

NorthCUA supports research and development of computer-use agents, including interface understanding, application workflows, and browser-based tasks. Its behavior depends on the supplied observations, prompts, tools, and execution environment.

  • Generated actions and claimed outcomes can be incorrect. Validate important state changes and final artifacts independently.
  • Long workflows and cross-site coordination remain challenging. Preserve intermediate work and provide explicit recovery and stopping behavior.
  • Screenshots, documents, and pages can contain misleading instructions. Keep user intent and tool permissions separate from observed content, and protect credentials in the runtime.
  • The report documents a grounding example with a training-seen control in a changed surrounding GUI state (§6.2, Figure 26). The reported scores should not be interpreted as proof that every evaluated control was unseen during training.
  • The research report also explores NorthCUA-Ultrafast. These repositories do not establish that its separate direct-action-selection mechanism or latency results apply to the released weights.

The release's file-size, SHA-256, tensor/index, tokenizer, and template checks establish artifact consistency. They do not establish end-to-end task accuracy or universal inference-engine compatibility.

License

The model weights and repository documentation are released under Apache-2.0. See NOTICE for attribution. We thank the Qwen team and the open-source research, training, and inference communities. NorthCUA is an independent model release.

Citation

If you use NorthCUA in your research, please cite our technical report (arXiv:2611.02102v1):

@misc{zhang2026northcua,
  title = {NorthCUA Technical Report: Turbocharging Computer-Use Agents through Experience at Scale},
  author = {Chaoyun Zhang and Bingxuan Li and Pinxue Guo and Yangfan Gao and Zikun Cai and Tianci Xie and Hui Li and Yuqi Huang and Yifei Cao and Bo Mao and Tian Tang and Qichang Zheng and Tongtong Liu and Xiaoxing Wang and Jinxiu Liu and Lizhi Lin and Zhou Shao and Maosen Zhou and Miao Zheng and Shuo Zhang and Yangji He and Kepeng Lei and Ning Zhao and Wei Shen and Zhenjiang Jin and Xinyue Zhang and Peng Sun and Zhenhua Han and Rui Zheng and Hang Yan},
  year = {2026},
  eprint = {2611.02102},
  archivePrefix = {arXiv},
  primaryClass = {cs.LG},
  url = {https://arxiv.org/pdf/2611.02102v1}
}

内容来源:Hugging Face 模型卡

在 Hugging Face 查看