use-computer 0.0.14

Python SDK for the use.computer macOS and iOS Computer Use API

use-computer Python SDK

Python client for use.computer — rent dedicated Mac minis with macOS and Apple simulator sandboxes built for computer-use agents.

pip install use-computer
export USE_COMPUTER_API_KEY=mk_live_...

from use_computer import Computer

with Computer().create() as mac:
    mac.exec_ssh("open -a TextEdit")
    mac.keyboard.type("hello")
    png = mac.screenshot.take_full_screen()

Full DSL reference (macOS + simulator): docs.use.computer/docs/sdk

Simulator sandboxes use type="ios" for the SDK/API route, but device_type and runtime can target any installed compatible CoreSimulator pair: iPhone or iPad with iOS, Apple Watch with watchOS, or Apple TV with tvOS. Vision is unavailable for now. If omitted, the gateway defaults to iPhone 17 Pro on the latest installed iOS runtime.

Examples

File	What it shows
examples/_1_hello_macos.py	create → exec → keyboard → screenshot
examples/_2_hello_ios.py	create simulator → open URL → screenshot
examples/_3_recording.py	start / stop / download a screen recording
examples/_4_file_transfer.py	upload bytes, download a file back
examples/_5_keepalive.py	heartbeat for sessions idle > 2 min

For agent loops and evals: use-computer-cookbook.

Skill for AI coding assistants

Point your assistant at use-computer-cookbook/skills/SKILL.md — short body with per-topic references for macOS, Apple simulators, lifecycle, and the Harbor harness.

HTTP API

Every SDK method wraps https://api.use.computer/v1/... with Authorization: Bearer mk_live_.... Swagger: api.use.computer/docs. OpenAPI spec: api.use.computer/openapi.yaml.