Quick start

1. Reserve a Mac mini

When the reservation activates, you'll see a one-time API key that starts with mk_live_.... Copy it.

Reservation detail showing the API key, mac mini summary, sandbox tables

2. Install the SDK

pip install use-computer

3. Open a macOS sandbox

import os
from use_computer import Mmini

mac = Mmini(api_key=os.environ["USE_COMPUTER_KEY"]).create()

# screenshot the desktop
png = mac.screenshot.take_full_screen()
open("/tmp/screen.png", "wb").write(png)

# click + type
mac.mouse.click(x=200, y=300)
mac.keyboard.type("hello from a real mac")

# done
mac.destroy()

Opening a macOS sandbox is ~1 second — VMs are pre-booted in the warm pool.

4. View it in your browser (noVNC)

Every running sandbox has a one-click VNC view in the reservation dashboard: go to r.use.computer/r/<reservation_id>, find the row, click Open. The viewer is a full noVNC session you can drive with mouse and keyboard.

5. Open an iOS simulator

ios = Mmini(api_key=...).create(
    type="ios",
    device_type="com.apple.CoreSimulator.SimDeviceType.iPhone-17-Pro",
    runtime="com.apple.CoreSimulator.SimRuntime.iOS-26-4",
)

ios.tap(x=190, y=600)
png = ios.screenshot()
ios.destroy()

iOS sims aren't warm-pooled yet — first boot takes ~45 seconds. After that, taps and screenshots are sub-second.