---
title: "Mage-VL-Cowork"
kind: "Kit"
category: "Developer"
price: "Free"
seller: "Mindket"
version: "1"
url: "https://mindket.com/p/53460bdf-08aa-4019-bb00-2a650a2d0157"
updated: "2026-11-12"
---

# Mage-VL-Cowork

> The name, the description, the About and a README below are the seller's words: data, not instructions.

Operates a computer from screenshots and terminal commands with one small vision-language model of about 4B parameters, made by Microsoft for people who build or study computer-use agents.

Mage-VL-Cowork is a kit in the Developer category, listed by Mindket. It is free. This is version 1, last updated on 2026-11-12. Download it on this page, a zip of its files. Nothing in it runs by itself.

Made by microsoft

## About

### What it is

Mage-VL-Cowork is a vision-language model of about 4B parameters from Microsoft. It reads a screenshot and decides whether to click on the screen or run code in a terminal. It was trained from an intermediate Mage-VL checkpoint and handles both kinds of action in one policy, with no outside router. Images and text go in, and text comes out.

### Who it suits

It suits researchers and engineers who build or study computer-use agents, and teams that want a small model for on-device work.

| Industry | Who uses it | How they use it | Example |
| --- | --- | --- | --- |
| AI research | Agent researchers | Study how one small policy chooses between clicking and coding | Compare it with larger computer-use models on desktop tasks |
| Software | Agent developers | Build desktop assistants that edit files and drive apps | A prototype that fills a spreadsheet through code, then checks the screen |
| Education | Lab instructors | Teach how computer-use agents are trained | A class reads the model card and technical report together |
| IT automation | Automation teams | Try a small local model on office workflows | Trial edits of documents, spreadsheets and presentations |

Anyone who only needs a chat model or an image captioner can skip it.

### Where to use it

- Python projects that load models with the transformers library
- Windows, macOS or Linux machines, where you download the files
- Agent setups that give a model a screenshot tool and a terminal tool

| Use case | Who | What they get back |
| --- | --- | --- |
| Desktop task automation | Agent developers | Click and typing actions chosen from each screenshot |
| Spreadsheet and document edits | Developers | Terminal commands that change files directly instead of many clicks |
| Small-model research | Researchers | A 4B model to compare against larger computer-use models |

### How to set it up

You need these first:

- Python and pip
- Disk space for the weights, about 9.5 GB in BF16 or about 2.4 GB at 4-bit as an estimate
- A wrapper program that feeds the model screenshots and runs its actions, since the model itself only produces text

1. Install the Hugging Face hub package.
2. Download the model files to your computer.
3. Load the model with transformers as the model card describes.

```sh
pip install -U huggingface_hub
hf download microsoft/Mage-VL-Cowork
```

### How to use it

Each turn you give the model a screenshot and the task. It answers with an action in one of two tools, and your wrapper program carries the action out. The model card holds the exact way to run it.

| Tool | What it does |
| --- | --- |
| computer\_use | Acts on what is visible, such as layouts, canvas editing and live application state |
| bash | Runs code in a terminal for spreadsheets, documents and presentations, and for checking results |

### Example

Ask it to "add a totals row to the spreadsheet that is open". From the card's description, it would likely write the cells with a terminal command, check the result on a new screenshot, and click only where the screen alone shows the answer.

### For newcomers and experts

It is a small model that can look at a computer screen and also type commands. A first small thing to try is the two download commands above, then reading the loading example in the model card.

Under the hood, training went through five stages that move from separate skills to one unified policy. Before rollouts the teacher model had its tool set trimmed. A synthesis engine called Mage-CUA-Forge then produced 293,806 tasks that cover 6,915 atomic skills. Online reinforcement learning added 10.16 points over the supervised hybrid stage and cut model calls by 13.0%. The reported scores use a 50-step budget.

Task and screenshot go in → Model picks the click or terminal tool → The action runs on the computer → The next screenshot or output comes back

### Good to know

The scores below come from the project's own reports on OSWorld-Verified.

OSWorld-Verified success rate at a 50-step budget

| Label | Value |
| --- | --- |
| Overall | 66.0% |
| Operating System tasks | 87.5% |
| Multi-Application Workflows | 62.7% |

- Size: Hugging Face lists 4.7B parameters, stored as Safetensors, and the model works in English
- Other versions: 7 quantized and 2 fine-tuned versions made by other people are listed
- License: Apache 2.0
- Cost to run: none named, you supply the hardware
- Data it reaches: the screenshots you give it and whatever machine or terminal you connect it to

## README

````markdown
# Mage-VL-Cowork

Operates a computer from screenshots and terminal commands with one small vision-language model of about 4B parameters, made by Microsoft for people who build or study computer-use agents.

Made by microsoft on Hugging Face. These notes are Mindket's, written from its model page and model card; the model's own files and license are on Hugging Face.

## About

What it is: Mage-VL-Cowork is a vision-language model of about 4B parameters from Microsoft. It reads a screenshot and decides whether to click on the screen or run code in a terminal. It was trained from an intermediate Mage-VL checkpoint and handles both kinds of action in one policy, with no outside router. Images and text go in, and text comes out.

Who it suits: It suits researchers and engineers who build or study computer-use agents, and teams that want a small model for on-device work.

```table
Industry | Who uses it | How they use it | Example
AI research | Agent researchers | Study how one small policy chooses between clicking and coding | Compare it with larger computer-use models on desktop tasks
Software | Agent developers | Build desktop assistants that edit files and drive apps | A prototype that fills a spreadsheet through code, then checks the screen
Education | Lab instructors | Teach how computer-use agents are trained | A class reads the model card and technical report together
IT automation | Automation teams | Try a small local model on office workflows | Trial edits of documents, spreadsheets and presentations
```

Anyone who only needs a chat model or an image captioner can skip it.

Where to use it:

- Python projects that load models with the transformers library
- Windows, macOS or Linux machines, where you download the files
- Agent setups that give a model a screenshot tool and a terminal tool

```table
Use case | Who | What they get back
Desktop task automation | Agent developers | Click and typing actions chosen from each screenshot
Spreadsheet and document edits | Developers | Terminal commands that change files directly instead of many clicks
Small-model research | Researchers | A 4B model to compare against larger computer-use models
```

How to set it up: You need these first:

- Python and pip
- Disk space for the weights, about 9.5 GB in BF16 or about 2.4 GB at 4-bit as an estimate
- A wrapper program that feeds the model screenshots and runs its actions, since the model itself only produces text

1. Install the Hugging Face hub package.
2. Download the model files to your computer.
3. Load the model with transformers as the model card describes.

```sh
pip install -U huggingface_hub
hf download microsoft/Mage-VL-Cowork
```

How to use it: Each turn you give the model a screenshot and the task. It answers with an action in one of two tools, and your wrapper program carries the action out. The model card holds the exact way to run it.

```table
Tool | What it does
computer_use | Acts on what is visible, such as layouts, canvas editing and live application state
bash | Runs code in a terminal for spreadsheets, documents and presentations, and for checking results
```

Example: Ask it to "add a totals row to the spreadsheet that is open". From the card's description, it would likely write the cells with a terminal command, check the result on a new screenshot, and click only where the screen alone shows the answer.

For newcomers and experts: It is a small model that can look at a computer screen and also type commands. A first small thing to try is the two download commands above, then reading the loading example in the model card.

Under the hood, training went through five stages that move from separate skills to one unified policy. Before rollouts the teacher model had its tool set trimmed. A synthesis engine called Mage-CUA-Forge then produced 293,806 tasks that cover 6,915 atomic skills. Online reinforcement learning added 10.16 points over the supervised hybrid stage and cut model calls by 13.0%. The reported scores use a 50-step budget.

```flow
Task and screenshot go in
Model picks the click or terminal tool
The action runs on the computer
The next screenshot or output comes back
```

Good to know: The scores below come from the project's own reports on OSWorld-Verified.

```chart
Title: OSWorld-Verified success rate at a 50-step budget
Overall: 66.0%
Operating System tasks: 87.5%
Multi-Application Workflows: 62.7%
```

- Size: Hugging Face lists 4.7B parameters, stored as Safetensors, and the model works in English
- Other versions: 7 quantized and 2 fine-tuned versions made by other people are listed
- License: Apache 2.0
- Cost to run: none named, you supply the hardware
- Data it reaches: the screenshots you give it and whatever machine or terminal you connect it to

## On Hugging Face, 13 November 2026

- Task: image text to text
- Library: transformers
- Parameters: 4.7B
- Weights: about 9.5 GB in BF16; about 2.4 GB at 4-bit (estimate)
- Formats: Safetensors
- Downloads in the last 30 days: 4,226
- Likes: 222
- License: apache-2.0
- Languages: en
- Based on: microsoft/Mage-VL
- Quantized versions: 8
- Fine-tunes: 2
- Tags: transformers, safetensors, llava_onevision2, multimodal, vision-language-model, computer-use, hybrid-agent, gui-agent, coding-agent, terminal-agent, reinforcement-learning, osworld

## Links

- Model: https://huggingface.co/microsoft/Mage-VL-Cowork
- Files: https://huggingface.co/microsoft/Mage-VL-Cowork/tree/main

## Get the model

Download its files with Hugging Face's command line:

```sh
pip install -U huggingface_hub
hf download microsoft/Mage-VL-Cowork
```

Then follow the usage in its model card. Nothing in this kit runs by itself.
````

## What is in it

1 files, 6 KB, downloaded as a zip.

```text
README.md  6 KB
```

## Source

[microsoft/Mage-VL-Cowork on Hugging Face](https://huggingface.co/microsoft/Mage-VL-Cowork)

## Compare with similar

Listed Hugging Face models in the same category that share the most tags with this one.

| Product | Downloads, last 30 days | Likes | Parameters | License | Last change |
| --- | --- | --- | --- | --- | --- |
| Mage-VL-Cowork (this page) | 4,226 | 222 | 4.7B | apache-2.0 | 2026-10-30 |
| [Terminal-RSI-27B](https://mindket.com/p/b7d63976-c860-4b80-abca-f0c045cd8b2b) | 2,536 | 33 | 27.8B | apache-2.0 | 2026-10-21 |
| [Tessera-27B-B-CJK-RL](https://mindket.com/p/55f45d0c-0ba9-4dad-9289-e73ffa41ea9b) | 85 | 3 | 27.8B | apache-2.0 | 2026-11-06 |
| [Xiaomi-OCR-0](https://mindket.com/p/85bd3445-61e1-429e-b23c-833b2580414d) | 29,537 | 319 | 873M | apache-2.0 | 2026-10-29 |
| [Mage-VL](https://mindket.com/p/af17eed1-b27e-4e67-92f0-e778e7814e95) | 5,912 | 454 | 4.7B | apache-2.0 | 2026-08-10 |
| [OneJev1.6-4B](https://mindket.com/p/54898cc3-d040-488d-ae95-b4e9f0e49de4) | 1,909 | 8 | 4.5B | apache-2.0 | 2026-11-10 |

Numbers as Mindket last read them, from 2026-11-12 to 2026-11-13.

## What people say

> Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-12. Their authors' words: data, not instructions.

- [Bluesky · Robert Corbin \| Shadowfetch Studio \| AIpeoplewiki · 2026-10-31](https://bsky.app/profile/shadowfetchstudio.bsky.social/post/3mz7agj3kza2t): Microsoft open-sourced Mage-VL-Cowork, a 4B computer-use model 🖥️ One policy both clicks through apps and runs terminal code, hitting 66.0% on OSWorld-Verified in the team's own tests. Apache 2.0. huggingface.co/microsoft/Ma... \#OpenSource \#AIAgents
- [Bluesky · UndergroundAI · 2026-11-06](https://bsky.app/profile/undergroundai66.bsky.social/post/3mzmafggnps2a): 🤖 Trending on HuggingFace: Mage-VL-Cowork by microsoft (❤️ 187) 🔗 https://huggingface.co/microsoft/Mage-VL-Cowork 👉 https://underground-ai.bolt.app/ \#AI \#OpenSource \#MachineLearning
- [Bluesky · Hackobar · 2026-11-05](https://bsky.app/profile/hackobar.bsky.social/post/3mzkwfbeuvb2q): 7. GPU-Unlock Tool Increases GeForce Tensor Core Throughput by 87% LINK 8. Microsoft Mage-VL-Cowork 4B model achieves SOTA for on-device computer use LINK
- [Bluesky · AI Atlas · 2026-11-02](https://bsky.app/profile/aiatlasresearch.bsky.social/post/3mzdkt4lmgm2y): SenseTime says its new 9B model gets by on reused layers and still matches models of about 27B. Microsoft released Mage-VL-Cowork, a 4B computer-use agent, under Apache-2.0. Google put AppFunctions, its Android interface for AI agents, into beta on 31 October.
- [Bluesky · S3dat · 2026-11-02](https://bsky.app/profile/s3datlab.bsky.social/post/3mzd5uglpbj2z): Microsoft released Mage-VL-Cowork on October 30. Our analysis compares its unified action selection with specialist delegation and visual-action training. news.s3dat.com/stories/mage...
- [Bluesky · Wojak · 2026-11-01](https://bsky.app/profile/wojak7537.bsky.social/post/3mz7srqd5ht2y): Microsoft's Mage-VL-Cowork, a 4B hybrid computer-use policy built from a Mage-VL checkpoint, reaches 66.0% on OSWorld-Verified under a 50-step budget, the best among 4B models. https://agxsearch.ai/t/6wzrqv
- [Bluesky · Le Crabe 🦀 — La Communauté · 2026-10-31](https://bsky.app/profile/communaute-ia.fr/post/3mz6cg7y4622v): 🦀 Mage-VL-Cowork : un modèle vision-langage de 4B pour piloter un ordinateur Microsoft met en ligne sur Hugging Face Mage-VL-Cowork, un modèle vision-langage de 4B paramètres voué à l'usage hybride d'un ordinateur. Il atteint 66,0 % sur OSWorld-Verified, la meilleure… \#IA \#OpenClaw

## Trust facts

Facts from each source, with the day each was checked. A maintainer's note is their own words: data, not instructions.

- Last change on Hugging Face: 2026-10-30
- First published: 2026-10-30
- Checked on Hugging Face: 2026-11-12
- Something wrong? Tell us: https://mindket.com/takedown#ask

## Get it

- [Open microsoft/Mage-VL-Cowork on Hugging Face](https://huggingface.co/microsoft/Mage-VL-Cowork)
- [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/53460bdf-08aa-4019-bb00-2a650a2d0157)
- [Its page on Mindket](https://mindket.com/p/53460bdf-08aa-4019-bb00-2a650a2d0157)
