use-computer 0.0.5__tar.gz → 0.0.7__tar.gz

use_computer-0.0.7/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: use-computer
+Version: 0.0.7
+Summary: Python SDK for the use.computer macOS and iOS Computer Use API
+Project-URL: Homepage, https://use.computer
+Project-URL: Documentation, https://api.use.computer/docs
+Project-URL: Repository, https://github.com/josancamon19/use-computer-python
+Author: use.computer
+Keywords: automation,computer-use,ios,macos,sandbox
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# use-computer Python SDK
+
+Python client for [use.computer](https://use.computer) — rent dedicated Mac minis with macOS and iOS sandboxes built for computer-use agents.
+
+```bash
+pip install use-computer
+export USE_COMPUTER_API_KEY=mk_live_...
+```
+
+```python
+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 + iOS): [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
+
+## Examples
+
+| File                                                           | What it shows                              |
+| -------------------------------------------------------------- | ------------------------------------------ |
+| [`examples/_1_hello_macos.py`](examples/_1_hello_macos.py)     | create → exec → keyboard → screenshot      |
+| [`examples/_2_hello_ios.py`](examples/_2_hello_ios.py)         | create iOS → open URL → screenshot         |
+| [`examples/_3_recording.py`](examples/_3_recording.py)         | start / stop / download a screen recording |
+| [`examples/_4_file_transfer.py`](examples/_4_file_transfer.py) | upload bytes, download a file back         |
+| [`examples/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for sessions idle > 2 min        |
+
+For agent loops and evals: [use-computer-cookbook](https://github.com/josancamon19/use-computer-cookbook).
+
+## HTTP API
+
+Every SDK method wraps `https://api.use.computer/v1/...` with `Authorization: Bearer mk_live_...`. Swagger: [api.use.computer/docs](https://api.use.computer/docs). OpenAPI spec: [api.use.computer/openapi.yaml](https://api.use.computer/openapi.yaml).

use_computer-0.0.7/README.md

@@ -0,0 +1,35 @@
+# use-computer Python SDK
+
+Python client for [use.computer](https://use.computer) — rent dedicated Mac minis with macOS and iOS sandboxes built for computer-use agents.
+
+```bash
+pip install use-computer
+export USE_COMPUTER_API_KEY=mk_live_...
+```
+
+```python
+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 + iOS): [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
+
+## Examples
+
+| File                                                           | What it shows                              |
+| -------------------------------------------------------------- | ------------------------------------------ |
+| [`examples/_1_hello_macos.py`](examples/_1_hello_macos.py)     | create → exec → keyboard → screenshot      |
+| [`examples/_2_hello_ios.py`](examples/_2_hello_ios.py)         | create iOS → open URL → screenshot         |
+| [`examples/_3_recording.py`](examples/_3_recording.py)         | start / stop / download a screen recording |
+| [`examples/_4_file_transfer.py`](examples/_4_file_transfer.py) | upload bytes, download a file back         |
+| [`examples/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for sessions idle > 2 min        |
+
+For agent loops and evals: [use-computer-cookbook](https://github.com/josancamon19/use-computer-cookbook).
+
+## HTTP API
+
+Every SDK method wraps `https://api.use.computer/v1/...` with `Authorization: Bearer mk_live_...`. Swagger: [api.use.computer/docs](https://api.use.computer/docs). OpenAPI spec: [api.use.computer/openapi.yaml](https://api.use.computer/openapi.yaml).

use_computer-0.0.7/examples/_1_hello_macos.py

@@ -0,0 +1,8 @@
+from use_computer import Computer
+
+with Computer().create() as mac:
+    mac.exec_ssh("open -a TextEdit")
+    mac.keyboard.type("hello from use.computer")
+    png = mac.screenshot.take_full_screen()
+    open("hello_macos.png", "wb").write(png)
+    print(f"saved hello_macos.png ({len(png)} bytes)")

use_computer-0.0.7/examples/_2_hello_ios.py

@@ -0,0 +1,7 @@
+from use_computer import Computer
+
+with Computer().create(type="ios") as ios:
+    ios.apps.open_url("https://example.com")
+    png = ios.screenshot.take_full_screen()
+    open("hello_ios.png", "wb").write(png)
+    print(f"saved hello_ios.png ({len(png)} bytes)")

use_computer-0.0.7/examples/_3_recording.py

@@ -0,0 +1,10 @@
+import time
+
+from use_computer import Computer
+
+with Computer().create() as mac:
+    rec = mac.recording.start(name="demo")
+    time.sleep(5)
+    mac.recording.stop(rec.id)
+    mac.recording.download(rec.id, "demo.mp4")
+    print("saved demo.mp4")

use_computer-0.0.7/examples/_4_file_transfer.py

@@ -0,0 +1,7 @@
+from use_computer import Computer
+
+with Computer().create() as mac:
+    # Seed data files the task needs before handing the sandbox to an agent.
+    mac.upload_bytes(b"hello from use.computer\n", "/Users/lume/Desktop/hello.txt")
+    mac.download_file("/Users/lume/Desktop/hello.txt", "hello.txt")
+    print("saved hello.txt")

use_computer-0.0.7/examples/_5_keepalive.py

@@ -0,0 +1,9 @@
+import time
+
+from use_computer import Computer
+
+with Computer().create() as mac:
+    mac.start_keepalive(interval=30)
+    time.sleep(180)
+    png = mac.screenshot.take_full_screen()
+    print(f"still alive: screenshot {len(png)} bytes")

{use_computer-0.0.5 → use_computer-0.0.7}/mmini/tasks/__init__.py

@@ -29,6 +29,13 @@ def _render(text: str, **kwargs: str) -> str:
     return out
 
 
+def _strip_ios_prefix(s: str, kind: str) -> str:
+    """Drop boilerplate `com.apple.CoreSimulator.<kind>.` so the toml is readable.
+    `kind` is "SimDeviceType" or "SimRuntime"."""
+    prefix = f"com.apple.CoreSimulator.{kind}."
+    return s[len(prefix) :] if s.startswith(prefix) else s
+
+
 @dataclass
 class TaskSummary:
     """Lightweight task info from the list endpoint."""
@@ -66,6 +73,8 @@ class Task:
     accessibility_tree: dict | None = None
     grader: str = ""
     setup_actions: list = field(default_factory=list)
+    device_type: str = ""
+    runtime: str = ""
 
     @property
     def runnable(self) -> bool:
@@ -115,6 +124,8 @@ class TasksClient:
             accessibility_tree=d.get("accessibility_tree"),
             grader=d.get("grader", ""),
             setup_actions=d.get("setup_actions") or [],
+            device_type=d.get("device_type", ""),
+            runtime=d.get("runtime", ""),
         )
 
     def export_harbor(
@@ -227,7 +238,10 @@ def task_to_harbor(
     # instruction.md
     (task_dir / "instruction.md").write_text(task.instruction + "\n", encoding="utf-8")
 
-    # task.toml
+    # task.toml — append the [ios] block when the task pins a device/runtime so
+    # the runner can spin up the matching simulator. Long
+    # com.apple.CoreSimulator.* identifiers are shortened to the readable form
+    # ("iPhone-17-Pro" / "iOS-26-4"); the runner reconstructs the prefix.
     tags = ["collected", "gui", task.platform]
     if category:
         tags.append(category)
@@ -237,6 +251,16 @@ def task_to_harbor(
         PLATFORM=task.platform,
         RUNNABLE="true" if task.runnable else "false",
     )
+    if task.platform == "ios":
+        device_type = _strip_ios_prefix(task.device_type, "SimDeviceType")
+        runtime = _strip_ios_prefix(task.runtime, "SimRuntime")
+        if device_type or runtime:
+            ios_block = ["\n[ios]\n"]
+            if device_type:
+                ios_block.append(f'device_type = "{device_type}"\n')
+            if runtime:
+                ios_block.append(f'runtime = "{runtime}"\n')
+            toml += "".join(ios_block)
     (task_dir / "task.toml").write_text(toml, encoding="utf-8")
 
     # actions.json — flat {steps: [{function, args}, ...]} for the debug agent's

{use_computer-0.0.5 → use_computer-0.0.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.5"
+version = "0.0.7"
 description = "Python SDK for the use.computer macOS and iOS Computer Use API"
 readme = "README.md"
 requires-python = ">=3.10"

use_computer-0.0.5/PKG-INFO

@@ -1,100 +0,0 @@
-Metadata-Version: 2.4
-Name: use-computer
-Version: 0.0.5
-Summary: Python SDK for the use.computer macOS and iOS Computer Use API
-Project-URL: Homepage, https://use.computer
-Project-URL: Documentation, https://api.use.computer/docs
-Project-URL: Repository, https://github.com/josancamon19/use-computer-python
-Author: use.computer
-Keywords: automation,computer-use,ios,macos,sandbox
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Typing :: Typed
-Requires-Python: >=3.10
-Requires-Dist: httpx>=0.27
-Description-Content-Type: text/markdown
-
-# use-computer Python SDK
-
-Python client for use.computer macOS and iOS sandboxes.
-
-```bash
-pip install use-computer
-export USE_COMPUTER_API_KEY=mk_live_...
-```
-
-```python
-from use_computer import Computer
-
-computer = Computer()
-sandbox = computer.create()  # macOS
-
-try:
-    png = sandbox.screenshot.take_full_screen()
-    sandbox.mouse.click(500, 400)
-    sandbox.keyboard.type("hello")
-    sandbox.exec_ssh("open -a TextEdit")
-finally:
-    sandbox.close()
-    computer.close()
-```
-
-## iOS
-
-```python
-from use_computer import Computer
-
-computer = Computer()
-ios = computer.create(type="ios")
-try:
-    ios.apps.open_url("https://example.com")
-    ios.input.tap(200, 300)
-    ios.input.type_text("hello")
-    ios.environment.set_appearance("dark")
-finally:
-    ios.close()
-    computer.close()
-```
-
-In runner configs, use `platform: ios`; the runner calls the iOS SDK create path under the hood.
-
-## Action DSL
-
-Actions are dotted method calls plus args/kwargs. They are useful when a model emits tool-like steps. Given an open macOS `sandbox`:
-
-```python
-from use_computer import Action, parse_pyautogui, parse_xdotool
-
-actions = [
-    Action("mouse.move", [500, 400]),
-    Action("mouse.click", [500, 400]),
-    Action("keyboard.hotkey", ["command+space"]),
-    Action("keyboard.type", ["Safari"]),
-    Action("screenshot.take_full_screen"),
-]
-
-for action in actions:
-    action.execute(sandbox)
-
-for action in parse_pyautogui("pyautogui.click(100, 200); pyautogui.write('hi')"):
-    action.execute(sandbox)
-
-for action in parse_xdotool("xdotool mousemove 100 200 click 1 type hello"):
-    action.execute(sandbox)
-```
-
-Common macOS targets: `mouse.*`, `keyboard.*`, `screenshot.*`, `display.*`, `recording.*`.
-
-Common iOS targets: `input.*`, `apps.*`, `environment.*`, `screenshot.*`, `recording.*`.
-
-Docs: https://api.use.computer/docs
-
-OpenAPI: https://api.use.computer/openapi.yaml
-
-Examples: https://github.com/josancamon19/use-computer-examples

use_computer-0.0.5/README.md

@@ -1,78 +0,0 @@
-# use-computer Python SDK
-
-Python client for use.computer macOS and iOS sandboxes.
-
-```bash
-pip install use-computer
-export USE_COMPUTER_API_KEY=mk_live_...
-```
-
-```python
-from use_computer import Computer
-
-computer = Computer()
-sandbox = computer.create()  # macOS
-
-try:
-    png = sandbox.screenshot.take_full_screen()
-    sandbox.mouse.click(500, 400)
-    sandbox.keyboard.type("hello")
-    sandbox.exec_ssh("open -a TextEdit")
-finally:
-    sandbox.close()
-    computer.close()
-```
-
-## iOS
-
-```python
-from use_computer import Computer
-
-computer = Computer()
-ios = computer.create(type="ios")
-try:
-    ios.apps.open_url("https://example.com")
-    ios.input.tap(200, 300)
-    ios.input.type_text("hello")
-    ios.environment.set_appearance("dark")
-finally:
-    ios.close()
-    computer.close()
-```
-
-In runner configs, use `platform: ios`; the runner calls the iOS SDK create path under the hood.
-
-## Action DSL
-
-Actions are dotted method calls plus args/kwargs. They are useful when a model emits tool-like steps. Given an open macOS `sandbox`:
-
-```python
-from use_computer import Action, parse_pyautogui, parse_xdotool
-
-actions = [
-    Action("mouse.move", [500, 400]),
-    Action("mouse.click", [500, 400]),
-    Action("keyboard.hotkey", ["command+space"]),
-    Action("keyboard.type", ["Safari"]),
-    Action("screenshot.take_full_screen"),
-]
-
-for action in actions:
-    action.execute(sandbox)
-
-for action in parse_pyautogui("pyautogui.click(100, 200); pyautogui.write('hi')"):
-    action.execute(sandbox)
-
-for action in parse_xdotool("xdotool mousemove 100 200 click 1 type hello"):
-    action.execute(sandbox)
-```
-
-Common macOS targets: `mouse.*`, `keyboard.*`, `screenshot.*`, `display.*`, `recording.*`.
-
-Common iOS targets: `input.*`, `apps.*`, `environment.*`, `screenshot.*`, `recording.*`.
-
-Docs: https://api.use.computer/docs
-
-OpenAPI: https://api.use.computer/openapi.yaml
-
-Examples: https://github.com/josancamon19/use-computer-examples

use_computer-0.0.5/examples/ios_quickstart.py

@@ -1,89 +0,0 @@
-"""
-iOS simulator sandbox — end to end example.
-
-Creates an iPhone simulator, opens Safari, takes a screenshot,
-taps around, types a URL, and cleans up.
-
-Usage:
-    cd sdk && uv run python examples/ios_quickstart.py
-"""
-
-import time
-
-from use_computer import Computer
-
-client = Computer(base_url="http://localhost:8080")
-
-# Create an iOS sandbox (iPhone 17 Pro by default)
-sandbox = client.create(type="ios")
-print(f"Created: {sandbox}")
-
-# Check display info
-info = sandbox.display.get_info()
-print(f"Display: {info.width}x{info.height} @{info.scale}x")
-
-# Take initial screenshot (home screen)
-time.sleep(3)  # wait for simulator to settle
-img = sandbox.screenshot.take_full_screen()
-with open("ios_home.png", "wb") as f:
-    f.write(img)
-print(f"Home screen saved ({len(img)} bytes)")
-
-# Open Safari via URL scheme
-sandbox.apps.open_url("https://example.com")
-time.sleep(3)
-
-# Screenshot Safari
-img = sandbox.screenshot.take_full_screen()
-with open("ios_safari.png", "wb") as f:
-    f.write(img)
-print("Safari screenshot saved")
-
-# Tap the address bar (top center of screen)
-sandbox.input.tap(info.width / 2, 70)
-time.sleep(1)
-
-# Type a URL
-sandbox.input.type_text("https://apple.com")
-time.sleep(0.5)
-
-# Press Go (tap keyboard return area)
-sandbox.input.press_button("HOME")  # dismiss keyboard first
-time.sleep(1)
-
-# Screenshot final state
-img = sandbox.screenshot.take_full_screen()
-with open("ios_final.png", "wb") as f:
-    f.write(img)
-print("Final screenshot saved")
-
-# Set dark mode
-sandbox.environment.set_appearance("dark")
-time.sleep(1)
-img = sandbox.screenshot.take_full_screen()
-with open("ios_dark.png", "wb") as f:
-    f.write(img)
-print("Dark mode screenshot saved")
-
-# Upload a file to the simulator
-sandbox.upload_bytes(b"Hello from use.computer iOS!", "Documents/test.txt")
-print("File uploaded")
-
-# Download it back
-sandbox.download_file("Documents/test.txt", "ios_downloaded.txt")
-with open("ios_downloaded.txt") as f:
-    print(f"Downloaded: {f.read()}")
-
-# Start recording
-rec = sandbox.recording.start(name="demo")
-print(f"Recording started: {rec.id}")
-time.sleep(3)
-
-# Stop recording
-rec = sandbox.recording.stop(rec.id)
-print(f"Recording stopped: {rec.status}")
-
-# Clean up
-sandbox.close()
-print("Sandbox destroyed.")
-client.close()

use_computer-0.0.5/examples/quickstart.py

@@ -1,45 +0,0 @@
-"""
-Quick test of the use-computer SDK against a local gateway.
-
-Usage:
-    cd sdk && uv run python examples/quickstart.py
-"""
-
-import time
-
-from use_computer import Computer
-
-client = Computer(base_url="http://localhost:8080")
-
-sandbox = client.create()
-print(f"Created: {sandbox}")
-print(f"VNC:     {sandbox.vnc_url}")
-
-# Open TextEdit via exec
-sandbox.exec_ssh("open -a TextEdit")
-time.sleep(2)
-
-# Click in the document area to focus it
-sandbox.mouse.click(512, 400)
-time.sleep(0.5)
-
-# Take initial screenshot
-img = sandbox.screenshot.take_full_screen()
-with open("screen.png", "wb") as f:
-    f.write(img)
-print(f"Screenshot saved to screen.png ({len(img)} bytes)")
-
-# Type something
-sandbox.keyboard.type("Hello from use.computer!")
-time.sleep(0.5)
-
-# Screenshot after typing
-img = sandbox.screenshot.take_full_screen()
-with open("screen_after.png", "wb") as f:
-    f.write(img)
-print("After typing saved to screen_after.png")
-
-# Clean up
-sandbox.close()
-print("Sandbox destroyed.")
-client.close()

use_computer-0.0.5/examples/setup_with_exec.py

@@ -1,54 +0,0 @@
-"""
-Example: seed a sandbox by running shell commands via exec.
-
-Opens Notes, creates a note, and sets system preferences — all via exec.
-This replaces the old seed mechanism with direct shell commands.
-
-Usage:
-    cd sdk && uv run python examples/setup_with_exec.py
-"""
-
-import asyncio
-
-from use_computer import AsyncComputer
-
-
-async def main() -> None:
-    client = AsyncComputer(base_url="http://localhost:8080")
-    sandbox = await client.create()
-    print(f"Created: {sandbox.sandbox_id}")
-
-    # Open an app
-    await sandbox.exec_ssh("open -a Notes")
-    await asyncio.sleep(2)
-
-    # Create a note via osascript
-    await sandbox.exec_ssh(
-        'osascript -e \'tell application "Notes" to make new note'
-        ' with properties {name:"Test Note", body:"Created by mmini SDK"}\''
-    )
-
-    # Set system preferences
-    await sandbox.exec_ssh("defaults write com.apple.dock autohide -bool true && killall Dock")
-
-    # Run any shell command
-    result = await sandbox.exec_ssh("sw_vers -productVersion")
-    print(f"macOS version: {result.stdout.strip()}")
-
-    # Verify the note was created
-    notes = await sandbox.exec_ssh(
-        "osascript -e 'tell application \"Notes\" to get the name of every note'"
-    )
-    print(f"Notes: {notes.stdout.strip()}")
-
-    # Take a screenshot to see the result
-    img = await sandbox.screenshot.take_full_screen()
-    with open("setup_result.png", "wb") as f:
-        f.write(img)
-    print("Screenshot saved to setup_result.png")
-
-    await sandbox.close()
-    await client.close()
-
-
-asyncio.run(main())

use_computer-0.0.5/examples/upload_file.py

@@ -1,43 +0,0 @@
-"""
-Example: upload a file to a sandbox and verify it.
-
-Uses the file upload endpoint to put a file on the VM's filesystem,
-then verifies it exists via exec.
-
-Usage:
-    cd sdk && uv run python examples/upload_file.py
-"""
-
-import asyncio
-
-from use_computer import AsyncComputer
-
-
-async def main() -> None:
-    client = AsyncComputer(base_url="http://localhost:8080")
-    sandbox = await client.create()
-    print(f"Created: {sandbox.sandbox_id}")
-
-    # Create some content
-    content = b"Name,Score\nAlice,95\nBob,87\nCharlie,92\n"
-
-    # Upload to the VM
-    await sandbox.upload_bytes(content, "/Users/lume/Desktop/scores.csv")
-    print("Uploaded scores.csv to Desktop")
-
-    # Verify it's there
-    result = await sandbox.exec_ssh("cat /Users/lume/Desktop/scores.csv")
-    print(f"File contents:\n{result.stdout}")
-
-    # Upload a script and run it
-    script = b"#!/bin/bash\necho 'Hello from uploaded script!'\nls ~/Desktop/\n"
-    await sandbox.upload_bytes(script, "/Users/lume/Desktop/check.sh")
-    await sandbox.exec_ssh("chmod +x /Users/lume/Desktop/check.sh")
-    result = await sandbox.exec_ssh("/Users/lume/Desktop/check.sh")
-    print(f"Script output:\n{result.stdout}")
-
-    await sandbox.close()
-    await client.close()
-
-
-asyncio.run(main())