Skip to content

About

No description, website, or topics provided.

Resources

Stars

17 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

19 Commits

Folders and files

Repository files navigation

πŸ§ͺ OSWorld-Science

A Benchmark of Computer Use Agents for Learning and Using Scientific Software

Can computer-use agents turn scientific intent into verifiable results inside real research software?

arXiv Project Page Hugging Face Tasks License

Paper Β· Project page Β· Dataset & VM images Β· Documentation


OSWorld-Science is a benchmark and evaluation environment for studying how computer-use agents solve scientifically meaningful tasks with professional software. Agents must interpret specialized interfaces, manipulate scientific objects, combine GUI and command-line actions, and leave behind results that can be checked for scientific correctness.

The benchmark connects expert-defined scientific goals to verifiable software outcomes. Its task-specific evaluators inspect application states and artifacts such as molecular structures, segmentation masks, plots, tables, and numerical results, awarding partial credit when a workflow is only partly complete.

146 tasks
Scientifically meaningful workflows
7 domains
From chemistry to linguistics
17 tools
Real scientific software
12 VLMs
Open and proprietary models

πŸ“Š Benchmark at a glance

The full benchmark reported in the paper contains 146 tasks across seven scientific domains:

Scientific domain Tasks Share Example workflows
Chemistry 43 29.5% Molecular drawing, paper extraction, retrosynthesis
Physics 31 21.2% CFD and engineering simulation
Medicine 26 17.8% Pathology and medical-image analysis
Statistics 20 13.7% Statistical computing, SQL, plots, and reporting
Biology 18 12.3% Structural biology, NMR, microscopy, and EEG analysis
Geographic information 6 4.1% GIS digitization, georeferencing, and spatial analysis
Linguistics 2 1.4% Acoustic analysis and annotation

The benchmark spans software configurations including QuPath, ChemDraw, ASKCOS, SAS/R, OpenFOAM, ANSYS, EEGLAB, PyMOL/Mnova, QGIS, CIAO + DS9, Weasis, Praat, 3D Slicer, and PDF viewers. All tasks require visual observation; 83.6% also support CLI access, while the remaining 16.4% are GUI-only under the recorded configurations.

🧭 Quick start

1. Check the host

OSWorld-Science currently supports Linux x86-64 hosts with KVM and Docker. Plan for approximately 8 GB RAM and 4 vCPUs per concurrent guest, plus disk space for the selected VM images. A full download of the eight public runner images is approximately 196 GB.

egrep -c '(vmx|svm)' /proc/cpuinfo  # must be greater than 0
ls -l /dev/kvm                      # must be accessible to your user

Python 3.11+ is managed with uv. The R-backed statistics evaluators additionally require Rscript (R 4.4.3).

See the full system requirements, or run the built-in environment check after installation:

uv run osci doctor

2. Install

git clone https://github.com/DiscoAILab/OSWorld-Science.git
cd OSWorld-Science

uv sync --extra hf       # core package + dev tools + Hugging Face downloader
cp .env.example .env     # add credentials only for the model backends you use

uv sync installs the core package and the default development tools (pytest and ruff). Optional extras are opt-in: hf downloads the dataset, grader supports grader tests, and biomed, chem, eeg, and geoscience provide domain-specific evaluator dependencies. Repeat --extra to combine them, or run uv sync --all-extras to install every extra.

3. Download tasks and VM images

# One domain and its prepared VM image
uv run python scripts/data_prep/hf_download.py --domain stat --vm

# All 146 tasks and every published VM image (~210 GB).
# --prune moves local-only files from older releases into a timestamped backup.
uv run python scripts/data_prep/hf_download.py --vm --prune

The files are downloaded from the OSWorld-Science dataset. Task data and graders are available for all 146 tasks. The EEGLAB guest image is not yet published, and the Windows/Ansys Fluent image cannot be redistributed; see the dataset card for current image availability.

After downloading, list the complete task registry and validate every task definition:

uv run osci tasks list       # list all available tasks, grouped by domain
uv run osci tasks validate   # check every task's schema, evaluator wiring, and snapshot

4. Run an evaluation

Use uv run osci models to list the model names configured in configs/models.yaml. --tasks accepts all, a domain name, or a comma-separated list of task IDs.

# One smoke-test task
uv run osci run \
  --models claude-sonnet-5 \
  --tasks stat_qol_sql \
  --run-name smoke

# One domain with three concurrent guests
uv run osci run \
  --models claude-sonnet-5 \
  --tasks stat \
  --workers 3 \
  --run-name stat-sweep

# Full model Γ— task sweep
uv run osci run \
  --models claude-sonnet-5,gpt-5.6-terra \
  --tasks all \
  --workers 3 \
  --run-name full

# Export PASS/FAIL/VOID counts, scores, steps, and costs
uv run osci report --run full

Reusing a run name resumes that run and skips completed model–task cells unless --force is supplied. See the running guide for manual VM control, parallelism, run artifacts, and all command-line options.

πŸ” How it works

task definition
      β”‚
      β”œβ”€β”€ reset a domain-specific VM
      β”œβ”€β”€ stage inputs and launch scientific software
      β”œβ”€β”€ run the agent: screenshot β†’ VLM β†’ GUI/CLI action
      β”œβ”€β”€ collect the requested deliverables
      └── score artifacts with task-specific executable evaluators
                              β”‚
                              └── score.json + trajectories + reports

Every task follows the OSWorld format: an agent receives a natural-language instruction, interacts with a desktop, and leaves behind a set of deliverables. Task definitions live in data/<domain>/tasks/*.json and specify the VM snapshot, staging steps, deliverables, and evaluator pipeline.

  • Agents. Registered factories live under osworld_science.agents. The built-in prompt agent uses the OSWorld PromptAgent interaction pattern; the built-in kimi agent is Moonshot's tool-calling agent, vendored from xlang-ai/OSWorld under Apache-2.0.
  • Models. configs/models.yaml records backend, upstream model ID, pricing, output limits, and optional agent selection.
  • Evaluators. The registry includes JSON, CSV, artifact, R, SQL, Slicer, and Praat evaluators, along with task-author-provided scientific checks.
  • Snapshots. configs/snapshots.yaml maps each task to a reproducible image, resource requirements, toolchain probes, and pre-task hooks.

πŸ“‚ Data layout

data/<domain>/
β”œβ”€β”€ tasks/     # task definitions
β”œβ”€β”€ public/    # inputs staged into the guest
β”œβ”€β”€ private/   # grader references and test suites
└── vm/        # prepared VM image and checksum

The name private/ means that its contents are hidden from the solver during a run; it is not an access-control boundary. The published dataset includes answer keys, so results from models that may have trained on the dataset should not be interpreted as held-out measurements.

Prepared VM images are approximately 23–34 GB each. Download an image with hf_download.py --domain <domain> --vm, or rebuild it from the official OSWorld base image with the corresponding script under scripts/vm_prep/.

πŸ“¦ Repository map

configs/               model and VM snapshot registries
data/                  downloaded tasks, references, inputs, and VM images
docs/                  user and developer guides
scripts/data_prep/     Hugging Face dataset synchronization
scripts/vm_prep/       reproducible domain-image build scripts
src/osworld_science/   agents, harness, VM control, evaluators, and CLI
tests/                 unit tests and grader-parity tests

πŸ“š Documentation

🍻 Acknowledgements

OSWorld-Science builds on and is inspired by the following open-source projects:

  • OSWorld, for establishing a foundational benchmark, environment, and interaction framework for evaluating multimodal agents on real computer tasks.
  • Orion, for pioneering computer-use agents for laboratory automation and inspiring scientific-software workflows in this benchmark.

We thank the authors and contributors of both projects for making their work publicly available to the research community.

πŸ“ Citation

If OSWorld-Science is useful in your work, please cite the paper:

@misc{dai2026osworldscience,
  title  = {{OSWorld-Science}: A Benchmark of Computer Use Agents for Learning and Using Scientific Software},
  author = {Dai, Dingyuan and Qi, Heli and Liu, Lei and Li, Yinxi and Chen, Baiding and Dou, Zijun and Zeng, Qingcheng and Kang, Qi and Sun, Oliver and Wang, Eric and Zhou, Bo and Wang, Haixin and Du, Yufan and Bo, Shi and Lin, Ruihan and Yuan, Mengqi and Lu, Dunjie and Dillmann, Steven and Shi, Yiming and Su, Tina and Xin, Xin and Liu, Minghao and Wang, Xi and Huang, Xu and Zhang, Ge and Nie, Pengyu and Yang, Zhen and Tang, Jie and Li, Juanzi and Xuan, Weihao and Liu, Tianyu},
  year={2026},
  eprint={2609.39903},
  archivePrefix={arXiv},
  primaryClass={cs.AI},
  url={https://arxiv.org/abs/2609.39903}, 
}

πŸ“„ License

This repository is released under the Creative Commons Attribution 4.0 International License. Individual third-party software, datasets, and vendored components remain subject to their respective licenses.

About

No description, website, or topics provided.

Resources

Stars

17 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages