Skip to content

Commit 0e3744c

Browse files
committed
update osworld docs
1 parent 3c2422e commit 0e3744c

File tree

2 files changed

+20
-39
lines changed

2 files changed

+20
-39
lines changed

experiments/osworld_docker_test.py

Lines changed: 0 additions & 37 deletions
This file was deleted.
Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The main entry point `experiments/run_osworld.py` is currently configured with h
3131
2. **Environment Variables:**
3232
- `AGENTLAB_DEBUG=1`: Automatically runs the debug subset (7 tasks from `osworld_debug_task_ids.json`)
3333

34-
### Running OSWorld Tasks
34+
### Task subsets
3535

3636
We provide different subsets of tasks:
3737

@@ -42,10 +42,28 @@ We provide different subsets of tasks:
4242
### Example Commands
4343

4444
```bash
45-
# Run with default debug subset (7 tasks)
45+
# Run with default debug subset using sequential execution in VMware VM
4646
python experiments/run_osworld.py
4747
```
4848

49+
### Parallel Execution with Docker
50+
To run OSWorld in parallel using Docker, ensure you have Docker installed and configured.
51+
To install it, follow the section from the OSWorld README on [Docker setup](https://github.com/xlang-ai/OSWorld?tab=readme-ov-file#docker-server-with-kvm-support-for-better-performance).
52+
Ensure that your docker installation support KVM, as OSWorld requires it for running VMs.
53+
We also recommend pulling the latest Docker image for OSWorld before running the benchmark:
54+
55+
```bash
56+
docker pull happysixd/osworld-docker
57+
```
58+
59+
After setting up Docker, you can change the `use_vmware` parameter in the script to `False` and run:
60+
61+
```bash
62+
python experiments/run_osworld.py
63+
```
64+
You can control number of parallel jobs by setting the `n_jobs` parameter in the script, the default is 4.
65+
We recommend setting `n_jobs` to `your_number_of_cpu_cores - 2` to leave some resources for the host system and the benchmark itself.
66+
4967

5068
### Configuration Notes
5169

0 commit comments

Comments
 (0)