← AI GitHub

AI GitHub

OSWorld for computer-use benchmarks

Evaluate agents that operate real desktop application interfaces in a controlled environment.

AutomationPublished 2 min read

Key Takeaways

  • OSWorld defines tasks with starting conditions and evaluators and runs them against desktop environments.
  • Confirm the desktop environment and observation or action interface match the evaluator.
  • Start with one task and inspect how the initial machine state is restored.
  • Image resolution, operating system and application version can change the task.

How it works

OSWorld defines tasks with starting conditions and evaluators and runs them against desktop environments. The agent works through observations and actions rather than through application-specific fixture APIs.

What you need

Confirm the desktop environment and observation or action interface match the evaluator. Pin the environment image when comparing runs that must see the same UI.

What to try first

Start with one task and inspect how the initial machine state is restored. Save the final artifacts and compare them with the evaluation result.

Test one basic input device action manually before running the agent. A keyboard layout or display scaling problem can make a good action look wrong.

Where to look for failures

Image resolution, operating system and application version can change the task. Pin the environment and separate setup failures from agent failures.

Related Franklin pages

Choose the benchmark that matches the interface you care about. Compare environment setup and scoring evidence before treating an aggregate as a measure of agent ability.

For an agent interface that reaches mobile apps, see Franklin’s guide to Phone-Use. Phone-Use

Project documentation

Try it for your workflow

Explore the project’s documentation for setup and usage, or save this page to a collection for later.

Read the project documentation ↗