Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
"""Launch a persistent local Android VM via the CLI.
cua sb launch android:14 --local --json
# parse name from JSON output, connect with SDK, run assertions
cua sb delete --force <name> --local
Mirrors tests/integration/sandbox_sdk/test_android_local_vm.py but exercises the CLI
launch path and persistent state tracking instead of Sandbox.ephemeral().
Requires Android SDK (emulator + adb) to be installed.
"""
from __future__ import annotations
import asyncio
import json
import subprocess
import pytest
from cua_sandbox import Sandbox
pytestmark = pytest.mark.asyncio
def _has_java() -> bool:
"""Only Java must be pre-installed — the Android SDK auto-installs on first run."""
try:
from cua_sandbox.runtime.android_emulator import _java_env
_java_env()
return True
except Exception:
return False
def _cua(*args: str) -> subprocess.CompletedProcess:
return subprocess.run(["cua", *args], capture_output=True, text=True)
def _ls_names() -> list[str]:
r = _cua("sb", "ls", "--all", "--json")
if r.returncode != 0:
return []
return [s["name"] for s in json.loads(r.stdout)]
@pytest.mark.skipif(not _has_java(), reason="Java not found (required to auto-install Android SDK)")
async def test_android_local_vm():
result = _cua("sb", "launch", "android:14", "--local", "--json")
assert result.returncode == 0, f"launch failed:\n{result.stderr}"
name = json.loads(result.stdout)["name"]
assert name in _ls_names(), f"'{name}' not found in `cua sb ls --all` after launch"
try:
async with Sandbox.connect(name, local=True) as sb:
screenshot = await sb.screenshot()
assert screenshot[:4] == b"\x89PNG"
assert len(screenshot) > 10000
w, h = await sb.screen.size()
assert w > 0 and h > 0
await sb.mobile.home()
finally:
_cua("sb", "delete", "--force", name, "--local")
assert name not in _ls_names(), f"'{name}' still in `cua sb ls --all` after delete"
async def main():
r = _cua("sb", "launch", "android:14", "--local", "--json")
print(f"launch exit={r.returncode}")
name = json.loads(r.stdout)["name"]
print(f"name: {name}")
try:
async with Sandbox.connect(name, local=True) as sb:
screenshot = await sb.screenshot()
print(f"Screenshot: {len(screenshot)} bytes")
with open("/tmp/cli_android_local_vm.png", "wb") as f:
f.write(screenshot)
w, h = await sb.screen.size()
print(f"Screen size: {w}x{h}")
await sb.mobile.tap(w // 2, h // 2)
await sb.mobile.home()
print("Tap + home: OK")
finally:
_cua("sb", "delete", "--force", name, "--local")
if __name__ == "__main__":
asyncio.run(main())