OSWorld

环境要求

• Python 环境与 pip（用于安装 requirements.txt 及 desktop-env）
• VMware Workstation Pro（Apple 芯片需 VMware Fusion）并配置好 vmrun 命令
• 可选：VirtualBox（VMware 不可用时替代，但并行与 Apple 芯片 macOS 支持不佳）
• 可选：Docker，需宿主机/服务器支持 KVM 以获得更好性能

安装与启动步骤

1. 1获取项目源码

   从 GitHub 克隆 OSWorld 仓库，后续依赖安装与运行脚本都在仓库目录内执行。

   git clone https://github.com/xlang-ai/OSWorld.git
   cd OSWorld

   复制

2. 2安装项目依赖

   在仓库根目录安装 requirements.txt 中的依赖；若只需要环境、不需要基准任务，可改用第二条命令。

   pip install -r requirements.txt

   复制

3. 3仅安装环境（可选）

   不使用任何基准任务、只想要桌面环境时，直接安装 desktop-env 包即可。

   pip install desktop-env

   复制

4. 4安装并配置 VMware

   安装 VMware Workstation Pro（Apple 芯片装 VMware Fusion），并配置好 vmrun 命令环境变量，具体流程见仓库文档。

5. 5验证 vmrun 可用

   执行后若能看到当前运行的虚拟机列表，说明 VMware 安装与环境变量配置成功。

   vmrun -T ws list

   复制

6. 6运行快速开始示例

   用最小示例与环境交互；使用 Docker 后端时需在初始化 DesktopEnv 时指定 provider_name 与 os_type。

   python quickstart.py

   复制

7. 7查看运行结果

   运行结果查看脚本，输出本次评估/交互的结果信息。

   python show_result.py

   复制

8. 8使用 Modal 沙箱运行

   不依赖本地 VMware 时可用 Modal 沙箱，通过命令行参数指定 provider 并开启无头模式。

   python quickstart.py --provider_name modal --headless true

   复制

关键配置

如何确认成功

运行 `vmrun -T ws list` 能看到当前运行的虚拟机列表，且 `python quickstart.py` 能正常与环境交互、`python show_result.py` 输出结果，即为配置成功。

常见问题

注意事项

• Docker 方案建议在支持 KVM 的服务器上运行以获得更好性能。
• Apple 芯片设备需安装 VMware Fusion 而非 VMware Workstation Pro。
• 对照结果时请与官网最新的 OSWorld-Verified 基准成绩比较。
• README 未给出完整的依赖安装首行，建议按官方仓库文档执行。