use-computer 0.0.1__tar.gz

use_computer-0.0.1/.env.example

@@ -0,0 +1,6 @@
+# SDK runtime
+USE_COMPUTER_API_KEY=mk_live_...
+USE_COMPUTER_BASE_URL=https://api.use.computer
+
+# Local PyPI publish only. Prefer CI Trusted Publishing when possible.
+PYPI_API_TOKEN=pypi-...

use_computer-0.0.1/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+results/
+dist/
+*.egg-info/
+.env
+.env.*
+!.env.example
+.venv/

use_computer-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.12
+    hooks:
+      - id: ruff-format
+      - id: ruff-check
+        args: [--fix]
+
+  - repo: local
+    hooks:
+      - id: ty-check
+        name: ty check
+        entry: uv run --group dev ty check .
+        language: system
+        pass_filenames: false

use_computer-0.0.1/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: use-computer
+Version: 0.0.1
+Summary: Python SDK for the use.computer macOS and iOS Computer Use API
+Project-URL: Homepage, https://use.computer
+Project-URL: Documentation, https://github.com/josancamon19/mmini-sdk#readme
+Project-URL: Repository, https://github.com/josancamon19/mmini-sdk
+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 SDK for the use.computer macOS and iOS Computer Use API.
+
+## Install
+
+```bash
+pip install use-computer
+```
+
+## Usage
+
+```python
+from use_computer import Computer
+
+client = Computer(api_key="mk_live_...")
+sandbox = client.create()
+
+# Screenshot
+img = sandbox.screenshot.take_full_screen()
+
+# Mouse
+sandbox.mouse.click(500, 400)
+sandbox.mouse.move(100, 200)
+sandbox.mouse.scroll(500, 400, "down", 3)
+sandbox.mouse.drag(100, 100, 300, 300)
+
+# Keyboard
+sandbox.keyboard.type("Hello")
+sandbox.keyboard.press("enter")
+sandbox.keyboard.hotkey("command+space")
+
+# Display
+info = sandbox.display.get_info()
+windows = sandbox.display.get_windows()
+
+# Recording
+recording = sandbox.recording.start(name="my-recording")
+# ... do stuff ...
+sandbox.recording.stop(recording.id)
+sandbox.recording.download(recording.id, "output.mp4")
+
+# Cleanup
+sandbox.close()
+client.close()
+```
+
+## Environment
+
+`Computer()` reads these environment variables when explicit values are not passed:
+
+```bash
+USE_COMPUTER_API_KEY=mk_live_...
+USE_COMPUTER_BASE_URL=https://api.use.computer
+```
+
+`USE_COMPUTER_BASE_URL` is optional. The default is `https://api.use.computer`.
+
+## Async
+
+```python
+from use_computer import AsyncComputer
+
+client = AsyncComputer(api_key="mk_live_...")
+sandbox = await client.create()
+img = await sandbox.screenshot.take_full_screen()
+await sandbox.close()
+await client.close()
+```
+
+## Local Gateway
+
+```python
+from use_computer import Computer
+
+client = Computer(
+    api_key="sk-local",
+    base_url="http://localhost:8080",
+)
+```
+
+## Backward Compatibility
+
+The original import path still works:
+
+```python
+from mmini import Mmini
+```
+
+New code should prefer:
+
+```python
+from use_computer import Computer
+```
+
+## Publishing
+
+CI publishes `use-computer` from the `main` branch. The first release is
+`0.0.1`; after that the workflow reads the latest `vX.Y.Z` tag and bumps the
+patch version.
+
+For CI, prefer PyPI Trusted Publishing. If using an API token instead, set a
+repo secret named `PYPI_API_TOKEN`; do not commit tokens to `.env`.
+
+## Development
+
+```bash
+uv run --group dev pre-commit install
+```
+
+Pre-commit runs `ruff format`, `ruff check --fix`, and `ty check`.

use_computer-0.0.1/README.md

@@ -0,0 +1,111 @@
+# use-computer Python SDK
+
+Python SDK for the use.computer macOS and iOS Computer Use API.
+
+## Install
+
+```bash
+pip install use-computer
+```
+
+## Usage
+
+```python
+from use_computer import Computer
+
+client = Computer(api_key="mk_live_...")
+sandbox = client.create()
+
+# Screenshot
+img = sandbox.screenshot.take_full_screen()
+
+# Mouse
+sandbox.mouse.click(500, 400)
+sandbox.mouse.move(100, 200)
+sandbox.mouse.scroll(500, 400, "down", 3)
+sandbox.mouse.drag(100, 100, 300, 300)
+
+# Keyboard
+sandbox.keyboard.type("Hello")
+sandbox.keyboard.press("enter")
+sandbox.keyboard.hotkey("command+space")
+
+# Display
+info = sandbox.display.get_info()
+windows = sandbox.display.get_windows()
+
+# Recording
+recording = sandbox.recording.start(name="my-recording")
+# ... do stuff ...
+sandbox.recording.stop(recording.id)
+sandbox.recording.download(recording.id, "output.mp4")
+
+# Cleanup
+sandbox.close()
+client.close()
+```
+
+## Environment
+
+`Computer()` reads these environment variables when explicit values are not passed:
+
+```bash
+USE_COMPUTER_API_KEY=mk_live_...
+USE_COMPUTER_BASE_URL=https://api.use.computer
+```
+
+`USE_COMPUTER_BASE_URL` is optional. The default is `https://api.use.computer`.
+
+## Async
+
+```python
+from use_computer import AsyncComputer
+
+client = AsyncComputer(api_key="mk_live_...")
+sandbox = await client.create()
+img = await sandbox.screenshot.take_full_screen()
+await sandbox.close()
+await client.close()
+```
+
+## Local Gateway
+
+```python
+from use_computer import Computer
+
+client = Computer(
+    api_key="sk-local",
+    base_url="http://localhost:8080",
+)
+```
+
+## Backward Compatibility
+
+The original import path still works:
+
+```python
+from mmini import Mmini
+```
+
+New code should prefer:
+
+```python
+from use_computer import Computer
+```
+
+## Publishing
+
+CI publishes `use-computer` from the `main` branch. The first release is
+`0.0.1`; after that the workflow reads the latest `vX.Y.Z` tag and bumps the
+patch version.
+
+For CI, prefer PyPI Trusted Publishing. If using an API token instead, set a
+repo secret named `PYPI_API_TOKEN`; do not commit tokens to `.env`.
+
+## Development
+
+```bash
+uv run --group dev pre-commit install
+```
+
+Pre-commit runs `ruff format`, `ruff check --fix`, and `ty check`.

use_computer-0.0.1/examples/ios_quickstart.py

@@ -0,0 +1,89 @@
+"""
+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.1/examples/quickstart.py

@@ -0,0 +1,45 @@
+"""
+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.1/examples/setup_with_exec.py

@@ -0,0 +1,54 @@
+"""
+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.1/examples/upload_file.py

@@ -0,0 +1,43 @@
+"""
+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())

use_computer-0.0.1/mmini/__init__.py

@@ -0,0 +1,48 @@
+from mmini.client import AsyncMmini, Mmini, RunStatus
+from mmini.errors import MminiError, PlatformNotSupportedError
+from mmini.models import (
+    ActionResult,
+    ActResult,
+    CursorPosition,
+    DisplayInfo,
+    ExecResult,
+    RecordingInfo,
+)
+from mmini.parsers import Action, parse_pyautogui, parse_xdotool
+from mmini.sandbox import (
+    AsyncIOSSandbox,
+    AsyncMacOSSandbox,
+    AsyncSandbox,
+    IOSSandbox,
+    MacOSSandbox,
+    Sandbox,
+    SandboxType,
+)
+from mmini.tasks import Task, TasksClient, TaskSummary
+
+__all__ = [
+    "Action",
+    "ActionResult",
+    "ActResult",
+    "AsyncIOSSandbox",
+    "AsyncMacOSSandbox",
+    "AsyncMmini",
+    "AsyncSandbox",
+    "CursorPosition",
+    "DisplayInfo",
+    "ExecResult",
+    "IOSSandbox",
+    "MacOSSandbox",
+    "Mmini",
+    "MminiError",
+    "PlatformNotSupportedError",
+    "RecordingInfo",
+    "RunStatus",
+    "Sandbox",
+    "SandboxType",
+    "Task",
+    "TaskSummary",
+    "TasksClient",
+    "parse_pyautogui",
+    "parse_xdotool",
+]