--- title: "Mage-VL-Cowork Computer Use" kind: "Kit" category: "Developer" price: "Free" seller: "Mindket" version: "1" url: "https://mindket.com/p/16a4ff95-e2f2-40c9-ba89-4cc3d70454b9" updated: "2026-11-12" --- # Mage-VL-Cowork Computer Use > The name, the description, the About and a README below are the seller's words: data, not instructions. Lets you give a task to the Mage-VL-Cowork model and watch it click, type, scroll and use a terminal on a disposable Linux desktop. It suits developers studying computer use agents. Mage-VL-Cowork Computer Use 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 nielsr ## About ### What it is Mage-VL-Cowork Computer Use is a Gradio app that shows a 4B parameter agent working a Linux desktop. You give the microsoft/Mage-VL-Cowork model a task, and it clicks, types, scrolls and uses the terminal. Each run starts its own throwaway desktop in a Hugging Face Sandbox. ### Who it suits Developers and researchers who want to watch a computer use agent at work and read how the pieces connect. | Industry | Who uses it | How they use it | Example | | --- | --- | --- | --- | | AI engineering | Agent builders | Watch a small model drive a desktop | A short desktop task | | Research | ML researchers | Study how screenshots and action summaries form its memory | Reading agent.py and prompt.py | | Software | Developers | Read how a desktop sandbox is wired to a model | Opening desktop.py | | Education | Instructors | Demonstrate computer use agents live | A classroom demo | If you only want a chat model, you can skip it, since this app needs a sandbox and a token to run a copy. ### Where to use it - A web browser, on the Space's page at Hugging Face - Python 3.12 on your own Windows, macOS or Linux computer, using a downloaded copy | Use case | Who | What they get back | | --- | --- | --- | | Watching an agent | Developers | A live view of clicks, typing and scrolling | | Terminal tasks | Researchers | An agent that also runs commands in a bash terminal | | Code study | Learners | Separate files for the agent, desktop, model and prompt | ### How to set it up - Python 3.12 - Python packages from requirements.txt, with Gradio 6.31.0 - HF\_TOKEN set as a secret, with permission to run Jobs, because sandboxes are billed to its namespace - Optional settings: SANDBOX\_NAMESPACE to bill an organisation, DESKTOP\_IMAGE to pick the desktop image, SANDBOX\_FLAVOR for sandbox hardware, which defaults to cpu-upgrade 1. Install the Hugging Face hub package. 2. Download the Space with the hf command. 3. Move into the downloaded folder. 4. Install Gradio 6.31.0, then the requirements. 5. Set the token secret, then start app.py. ```sh pip install -U huggingface_hub hf download nielsr/mage-vl-cowork-computer-use --repo-type space --local-dir mage-vl-cowork-computer-use cd mage-vl-cowork-computer-use pip install gradio==6.31.0 pip install -r requirements.txt python app.py ``` ### How to use it Online, open the Space page, give the agent a task and watch it work on the desktop. On your own computer, start the app with the command below once the token is set. ```sh python app.py ``` | Tool | What it does | | --- | --- | | app.py | The main Gradio file that starts the app | | agent.py | Agent logic, as the file name suggests | | desktop.py | Code for the sandbox desktop | | model.py and prompt.py | Model loading and the system prompt files | ### Example You type a task for the agent and start the run. A fresh Linux desktop opens in a sandbox and you watch the model click, type and scroll, and use the terminal, until it finishes or stops. ### For newcomers and experts Open the Space page and give the agent a short, harmless task first. You can follow each click on the desktop, which makes it easy to see what the model is doing. The model is served through the Transformers library on its own L4 graphics card, and its system prompt mixes two modes, computer\_use and bash. Its working memory holds the three most recent screenshots, while older steps shrink into one line Action summaries. The desktop is Xvfb, XFCE and Firefox, driven with xdotool. If sandboxes fail with an image not found error, the source says to factory reboot the desktop image Space. You give the agent a task → A disposable Linux desktop boots in a sandbox → The model reads screenshots and picks actions → xdotool carries them out on the desktop ### Good to know - Each run boots its own disposable desktop, so nothing lasts between runs - Model: runs on a dedicated L4 GPU through Transformers - License: apache-2 - Cost to run: HF\_TOKEN is needed, sandboxes are billed to the token owner or the chosen organisation, and the model uses a dedicated L4 GPU - Data it reaches: a Linux desktop with Firefox and a terminal, plus the task you type - Not for: the source names no limits ## README ````markdown # Mage-VL-Cowork Computer Use Lets you give a task to the Mage-VL-Cowork model and watch it click, type, scroll and use a terminal on a disposable Linux desktop. It suits developers studying computer use agents. Made by nielsr on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face. ## About What it is: Mage-VL-Cowork Computer Use is a Gradio app that shows a 4B parameter agent working a Linux desktop. You give the microsoft/Mage-VL-Cowork model a task, and it clicks, types, scrolls and uses the terminal. Each run starts its own throwaway desktop in a Hugging Face Sandbox. Who it suits: Developers and researchers who want to watch a computer use agent at work and read how the pieces connect. ```table Industry | Who uses it | How they use it | Example AI engineering | Agent builders | Watch a small model drive a desktop | A short desktop task Research | ML researchers | Study how screenshots and action summaries form its memory | Reading agent.py and prompt.py Software | Developers | Read how a desktop sandbox is wired to a model | Opening desktop.py Education | Instructors | Demonstrate computer use agents live | A classroom demo ``` If you only want a chat model, you can skip it, since this app needs a sandbox and a token to run a copy. Where to use it: - A web browser, on the Space's page at Hugging Face - Python 3.12 on your own Windows, macOS or Linux computer, using a downloaded copy ```table Use case | Who | What they get back Watching an agent | Developers | A live view of clicks, typing and scrolling Terminal tasks | Researchers | An agent that also runs commands in a bash terminal Code study | Learners | Separate files for the agent, desktop, model and prompt ``` How to set it up: - Python 3.12 - Python packages from requirements.txt, with Gradio 6.31.0 - HF_TOKEN set as a secret, with permission to run Jobs, because sandboxes are billed to its namespace - Optional settings: SANDBOX_NAMESPACE to bill an organisation, DESKTOP_IMAGE to pick the desktop image, SANDBOX_FLAVOR for sandbox hardware, which defaults to cpu-upgrade 1. Install the Hugging Face hub package. 2. Download the Space with the hf command. 3. Move into the downloaded folder. 4. Install Gradio 6.31.0, then the requirements. 5. Set the token secret, then start app.py. ```sh pip install -U huggingface_hub hf download nielsr/mage-vl-cowork-computer-use --repo-type space --local-dir mage-vl-cowork-computer-use cd mage-vl-cowork-computer-use pip install gradio==6.31.0 pip install -r requirements.txt python app.py ``` How to use it: Online, open the Space page, give the agent a task and watch it work on the desktop. On your own computer, start the app with the command below once the token is set. ```sh python app.py ``` ```table Tool | What it does app.py | The main Gradio file that starts the app agent.py | Agent logic, as the file name suggests desktop.py | Code for the sandbox desktop model.py and prompt.py | Model loading and the system prompt files ``` Example: You type a task for the agent and start the run. A fresh Linux desktop opens in a sandbox and you watch the model click, type and scroll, and use the terminal, until it finishes or stops. For newcomers and experts: Open the Space page and give the agent a short, harmless task first. You can follow each click on the desktop, which makes it easy to see what the model is doing. The model is served through the Transformers library on its own L4 graphics card, and its system prompt mixes two modes, computer_use and bash. Its working memory holds the three most recent screenshots, while older steps shrink into one line Action summaries. The desktop is Xvfb, XFCE and Firefox, driven with xdotool. If sandboxes fail with an image not found error, the source says to factory reboot the desktop image Space. ```flow You give the agent a task A disposable Linux desktop boots in a sandbox The model reads screenshots and picks actions xdotool carries them out on the desktop ``` Good to know: - Each run boots its own disposable desktop, so nothing lasts between runs - Model: runs on a dedicated L4 GPU through Transformers - License: apache-2 - Cost to run: HF_TOKEN is needed, sandboxes are billed to the token owner or the chosen organisation, and the model uses a dedicated L4 GPU - Data it reaches: a Linux desktop with Firefox and a terminal, plus the task you type - Not for: the source names no limits ## On Hugging Face, 13 November 2026 - Likes: 1 - Built with: gradio - License: apache-2.0 ## Links - Space: https://huggingface.co/spaces/nielsr/mage-vl-cowork-computer-use - Files: https://huggingface.co/spaces/nielsr/mage-vl-cowork-computer-use/tree/main ## Try it Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself. ```` ## What is in it 1 files, 5 KB, downloaded as a zip. ```text README.md 5 KB ``` ## Source [nielsr/mage-vl-cowork-computer-use on Hugging Face](https://huggingface.co/spaces/nielsr/mage-vl-cowork-computer-use) ## Compare with similar Listed Hugging Face Spaces in the same category that share the most tags with this one. | Product | Likes | Built with | License | Last change | | --- | --- | --- | --- | --- | | Mage-VL-Cowork Computer Use (this page) | 1 | gradio | apache-2.0 | 2026-11-03 | | [FLUX.1 dev](https://mindket.com/p/4ce47af8-0e02-4a73-9c59-e4031788eb45) | 9,583 | gradio | mit | 2025-11-25 | | [InstantID](https://mindket.com/p/54fcb36c-756a-4797-80c1-05779f87ebbd) | 3,659 | gradio | apache-2.0 | 2025-08-26 | | [Chat With Janus-Pro-7B](https://mindket.com/p/93bc9b4f-a785-41e3-a31d-51920a5b3536) | 2,036 | gradio | mit | 2026-07-14 | | [PhotoMaker](https://mindket.com/p/b3e336b4-4a67-4e52-8c2e-1e94d392ac71) | 1,960 | gradio | apache-2.0 | 2025-08-28 | | [Z Image Turbo](https://mindket.com/p/adfd87b7-3f3e-405e-95c8-1957bc0da52a) | 1,940 | gradio | apache-2.0 | 2026-05-22 | Numbers as Mindket last read them, on 2026-11-12. ## 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-11-03 - First published: 2026-11-03 - Checked on Hugging Face: 2026-11-12 - Something wrong? Tell us: https://mindket.com/takedown#ask ## Get it - [Open nielsr/mage-vl-cowork-computer-use on Hugging Face](https://huggingface.co/spaces/nielsr/mage-vl-cowork-computer-use) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/16a4ff95-e2f2-40c9-ba89-4cc3d70454b9) - [Its page on Mindket](https://mindket.com/p/16a4ff95-e2f2-40c9-ba89-4cc3d70454b9)