# Setup Osworld

Provision and verify an OSWorld-V2 checkout after clone.

- Repository: https://github.com/AMAP-ML/LongHorizon-Harness (1799 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-10-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add AMAP-ML/LongHorizon-Harness --skill setup-osworld -g -a claude-code -y`
Codex: `npx skills add AMAP-ML/LongHorizon-Harness --skill setup-osworld -g -a codex -y`
Cursor: `npx skills add AMAP-ML/LongHorizon-Harness --skill setup-osworld -g -a cursor -y`
Gemini CLI: `npx skills add AMAP-ML/LongHorizon-Harness --skill setup-osworld -g -a gemini-cli -y`

## Description

Provision and verify an OSWorld-V2 checkout after clone. Use when the user asks for OSWorld-V2 setup, installation, onboarding, AWS provider setup, Docker provider setup, mocked website server setup, GitLab server setup, gated task download, CUA-Harness hybrid experiment setup, or a final runnable export block. The skill should install/configure the selected supported infrastructure where possible, ask for user confirmation or credentials when required, and report what is fully configured versus still blocked.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Setup OSWorld

Use this skill to make a cloned OSWorld-V2 checkout runnable, not merely to
list environment variables. Provision every selected component that can be
configured safely from the current machine, and ask the user whenever an action
requires credentials, paid resources, DNS changes, SSH keys, secrets, or a
destructive/cloud operation.

## Supported Scope

Supported provider setup:

- `aws`: fully provision required AWS network resources with AWS CLI, then
  export the values OSWorld needs.
- `docker`: install/verify Docker and KVM where possible, then verify the
  Docker provider can run.

Unsupported provider setup for now:

- `vmware`, `virtualbox`, `azure`, `gcp`, `aliyun`, and `volcengine`.

For unsupported providers, load `references/unsupported-providers.md`, state
that this skill does not automate them yet, and ask whether the user wants AWS
or Docker instead.

Optional service setup:

- OSWorld-web mocked website server, using `Task-Web/OSWorld-web`.
- GitLab server, using `Task-Web/gitlab`.
- Gated task class download from Hugging Face.
- Task-scoped proxy setup following upstream OSWorld section 2.3, plus optional
  host-side proxy or HF mirror setup.
- CUA-Harness hybrid experiment overlay when this checkout includes
  `experiments/osworld_v2_hybrid` and the sibling `cua-harness/` source tree.

## Start With Intake

Ask before doing infrastructure work unless the user has already supplied the
answers.

Ask for:

The rest: https://github.com/AMAP-ML/LongHorizon-Harness/blob/HEAD/eval/OSWorldv2-harness/OSWorld-V2/.claude/skills/setup-osworld/SKILL.md