use-computer 0.0.22__tar.gz → 0.0.24__tar.gz

{use_computer-0.0.22 → use_computer-0.0.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.22
+Version: 0.0.24
 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
@@ -60,6 +60,19 @@ recording/file surface as macOS; exec runs in-guest via PowerShell/cmd
 (`win.run` / `win.shell`) instead of SSH. `AsyncWindowsSandbox` mirrors it.
 See [docs.use.computer/docs/windows](https://docs.use.computer/docs/windows).
 
+### Ubuntu (Beta)
+
+```python
+with Computer().create(type="ubuntu", version="ubuntu-24.04") as ubuntu:
+    print(ubuntu.run("uname -a").stdout)  # bash exec (no SSH)
+    ubuntu.keyboard.type("hello")
+    ubuntu.screenshot.take_full_screen()
+```
+
+Ubuntu sandboxes are **Beta** (admin-only). They use the same KVM/noVNC backend
+as Windows; pass `version="ubuntu-24.04"` to select a specific image. Exec
+defaults to bash and the macOS accessibility tree is not available yet.
+
 Full DSL reference (macOS + simulator): [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
 
 Simulator sandboxes use `type=SandboxType.IOS` for the SDK route, but

{use_computer-0.0.22 → use_computer-0.0.24}/README.md

@@ -38,6 +38,19 @@ recording/file surface as macOS; exec runs in-guest via PowerShell/cmd
 (`win.run` / `win.shell`) instead of SSH. `AsyncWindowsSandbox` mirrors it.
 See [docs.use.computer/docs/windows](https://docs.use.computer/docs/windows).
 
+### Ubuntu (Beta)
+
+```python
+with Computer().create(type="ubuntu", version="ubuntu-24.04") as ubuntu:
+    print(ubuntu.run("uname -a").stdout)  # bash exec (no SSH)
+    ubuntu.keyboard.type("hello")
+    ubuntu.screenshot.take_full_screen()
+```
+
+Ubuntu sandboxes are **Beta** (admin-only). They use the same KVM/noVNC backend
+as Windows; pass `version="ubuntu-24.04"` to select a specific image. Exec
+defaults to bash and the macOS accessibility tree is not available yet.
+
 Full DSL reference (macOS + simulator): [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
 
 Simulator sandboxes use `type=SandboxType.IOS` for the SDK route, but

{use_computer-0.0.22 → use_computer-0.0.24}/pyproject.toml

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

{use_computer-0.0.22 → use_computer-0.0.24}/use_computer/__init__.py

@@ -15,11 +15,13 @@ from use_computer.sandbox import (
     AsyncIOSSandbox,
     AsyncMacOSSandbox,
     AsyncSandbox,
+    AsyncUbuntuSandbox,
     AsyncWindowsSandbox,
     IOSSandbox,
     MacOSSandbox,
     Sandbox,
     SandboxType,
+    UbuntuSandbox,
     WindowsSandbox,
 )
 from use_computer.simulators import (
@@ -42,6 +44,7 @@ __all__ = [
     "AsyncMacOSSandbox",
     "AsyncComputer",
     "AsyncSandbox",
+    "AsyncUbuntuSandbox",
     "AsyncWindowsSandbox",
     "Button",
     "Computer",
@@ -63,6 +66,7 @@ __all__ = [
     "TaskSummary",
     "TasksClient",
     "UseComputerError",
+    "UbuntuSandbox",
     "WindowsSandbox",
     "family_for_device",
     "is_usable_device_type",

{use_computer-0.0.22 → use_computer-0.0.24}/use_computer/client.py

@@ -14,11 +14,13 @@ from use_computer.sandbox import (
     AsyncIOSSandbox,
     AsyncMacOSSandbox,
     AsyncSandbox,
+    AsyncUbuntuSandbox,
     AsyncWindowsSandbox,
     IOSSandbox,
     MacOSSandbox,
     Sandbox,
     SandboxType,
+    UbuntuSandbox,
     WindowsSandbox,
 )
 from use_computer.simulators import SimulatorFamily, select_simulator
@@ -26,7 +28,7 @@ from use_computer.tasks import TasksClient
 
 DEFAULT_BASE_URL = "https://api.use.computer"
 
-SandboxTypeInput = SandboxType | Literal["macos", "ios", "windows"]
+SandboxTypeInput = SandboxType | Literal["macos", "ios", "windows", "ubuntu"]
 
 
 def _resolve_api_key(api_key: str | None) -> str | None:
@@ -135,9 +137,19 @@ class Computer:
         self,
         *,
         type: Literal["windows", SandboxType.WINDOWS],
+        version: str = ...,
         host: str = ...,
     ) -> WindowsSandbox: ...
 
+    @overload
+    def create(
+        self,
+        *,
+        type: Literal["ubuntu", SandboxType.UBUNTU],
+        version: str = ...,
+        host: str = ...,
+    ) -> UbuntuSandbox: ...
+
     def create(
         self,
         *,
@@ -146,7 +158,8 @@ class Computer:
         family: SimulatorFamily | str | None = None,
         device_type: str = "",
         runtime: str = "",
-    ) -> MacOSSandbox | IOSSandbox | WindowsSandbox:
+        version: str = "",
+    ) -> MacOSSandbox | IOSSandbox | WindowsSandbox | UbuntuSandbox:
         """Create a new sandbox.
 
         Args:
@@ -155,11 +168,15 @@ class Computer:
             family: Simulator family enum/alias, for example SimulatorFamily.TV.
             device_type: Simulator device type identifier, for exact pinning.
             runtime: Simulator runtime identifier, for exact pinning.
+            version: KVM desktop image version, for example "windows-11",
+                "windows-10", or "ubuntu-24.04".
         """
         sandbox_type = _normalize_sandbox_type(type)
         body: dict = {"type": sandbox_type.value}
         if host:
             body["host"] = host
+        if sandbox_type in (SandboxType.WINDOWS, SandboxType.UBUNTU) and version:
+            body["version"] = version
         if sandbox_type == SandboxType.IOS:
             if family and (not device_type or not runtime):
                 choice = select_simulator(self.platforms(), family)
@@ -183,6 +200,15 @@ class Computer:
                 http=self._http,
                 vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
                 host=data.get("host", ""),
+                version=data.get("version", ""),
+            )
+        if sandbox_type == SandboxType.UBUNTU:
+            return UbuntuSandbox(
+                sandbox_id=sid,
+                http=self._http,
+                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                host=data.get("host", ""),
+                version=data.get("version", ""),
             )
         return MacOSSandbox(
             sandbox_id=sid,
@@ -207,6 +233,15 @@ class Computer:
                 http=self._http,
                 vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
                 host=data.get("host", ""),
+                version=data.get("version", ""),
+            )
+        if sb_type == SandboxType.UBUNTU:
+            return UbuntuSandbox(
+                sandbox_id=data["sandbox_id"],
+                http=self._http,
+                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                host=data.get("host", ""),
+                version=data.get("version", ""),
             )
         return MacOSSandbox(
             sandbox_id=data["sandbox_id"],
@@ -321,9 +356,19 @@ class AsyncComputer:
         self,
         *,
         type: Literal["windows", SandboxType.WINDOWS],
+        version: str = ...,
         host: str = ...,
     ) -> AsyncWindowsSandbox: ...
 
+    @overload
+    async def create(
+        self,
+        *,
+        type: Literal["ubuntu", SandboxType.UBUNTU],
+        version: str = ...,
+        host: str = ...,
+    ) -> AsyncUbuntuSandbox: ...
+
     async def create(
         self,
         *,
@@ -332,7 +377,8 @@ class AsyncComputer:
         family: SimulatorFamily | str | None = None,
         device_type: str = "",
         runtime: str = "",
-    ) -> AsyncMacOSSandbox | AsyncIOSSandbox | AsyncWindowsSandbox:
+        version: str = "",
+    ) -> AsyncMacOSSandbox | AsyncIOSSandbox | AsyncWindowsSandbox | AsyncUbuntuSandbox:
         """Create a new sandbox.
 
         Args:
@@ -341,11 +387,15 @@ class AsyncComputer:
             family: Simulator family enum/alias, for example SimulatorFamily.TV.
             device_type: Simulator device type identifier, for exact pinning.
             runtime: Simulator runtime identifier, for exact pinning.
+            version: KVM desktop image version, for example "windows-11",
+                "windows-10", or "ubuntu-24.04".
         """
         sandbox_type = _normalize_sandbox_type(type)
         body: dict = {"type": sandbox_type.value}
         if host:
             body["host"] = host
+        if sandbox_type in (SandboxType.WINDOWS, SandboxType.UBUNTU) and version:
+            body["version"] = version
         if sandbox_type == SandboxType.IOS:
             if family and (not device_type or not runtime):
                 choice = select_simulator(await self.platforms(), family)
@@ -369,6 +419,15 @@ class AsyncComputer:
                 http=self._http,
                 vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
                 host=data.get("host", ""),
+                version=data.get("version", ""),
+            )
+        if sandbox_type == SandboxType.UBUNTU:
+            return AsyncUbuntuSandbox(
+                sandbox_id=sid,
+                http=self._http,
+                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                host=data.get("host", ""),
+                version=data.get("version", ""),
             )
         return AsyncMacOSSandbox(
             sandbox_id=sid,
@@ -393,6 +452,15 @@ class AsyncComputer:
                 http=self._http,
                 vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
                 host=data.get("host", ""),
+                version=data.get("version", ""),
+            )
+        if sb_type == SandboxType.UBUNTU:
+            return AsyncUbuntuSandbox(
+                sandbox_id=data["sandbox_id"],
+                http=self._http,
+                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                host=data.get("host", ""),
+                version=data.get("version", ""),
             )
         return AsyncMacOSSandbox(
             sandbox_id=data["sandbox_id"],

{use_computer-0.0.22 → use_computer-0.0.24}/use_computer/sandbox.py

@@ -27,6 +27,7 @@ class SandboxType(str, Enum):
     MACOS = "macos"
     IOS = "ios"
     WINDOWS = "windows"
+    UBUNTU = "ubuntu"
 
 
 # ---------------------------------------------------------------------------
@@ -256,14 +257,17 @@ class IOSSandbox(Sandbox):
 
 
 class _NoAxeAccessibility:
-    """Mixin: Windows has no macOS axe-schema tree — `.accessibility` raises, use `.ui_tree()`."""
+    """Mixin for desktop guests without the macOS axe-schema tree."""
+
+    _accessibility_sandbox_type = "desktop"
+    _accessibility_hint = "accessibility tree is not supported for this sandbox"
 
     @property
     def accessibility(self):
         raise PlatformNotSupportedError(
             action="accessibility (macOS axe schema)",
-            sandbox_type="windows",
-            hint="use .ui_tree() for the native Windows UIAutomation tree",
+            sandbox_type=self._accessibility_sandbox_type,
+            hint=self._accessibility_hint,
         )
 
     @accessibility.setter
@@ -279,6 +283,9 @@ class WindowsSandbox(_NoAxeAccessibility, Sandbox):
     macOS axe-schema `.accessibility` raises PlatformNotSupportedError here.
     """
 
+    _accessibility_sandbox_type = "windows"
+    _accessibility_hint = "use .ui_tree() for the native Windows UIAutomation tree"
+
     def __init__(
         self,
         sandbox_id: str,
@@ -286,9 +293,11 @@ class WindowsSandbox(_NoAxeAccessibility, Sandbox):
         *,
         vnc_url: str = "",
         host: str = "",
+        version: str = "",
     ):
         super().__init__(sandbox_id, SandboxType.WINDOWS, http, vnc_url=vnc_url)
         self.host = host
+        self.version = version
         # Mouse/keyboard hit the same gateway command path as macOS.
         self.mouse = Mouse(http, self._prefix)
         self.keyboard = Keyboard(http, self._prefix)
@@ -324,6 +333,52 @@ class WindowsSandbox(_NoAxeAccessibility, Sandbox):
         return resp.json()
 
 
+class UbuntuSandbox(_NoAxeAccessibility, Sandbox):
+    """Ubuntu desktop VM sandbox — mouse, keyboard, bash exec, VNC."""
+
+    _accessibility_sandbox_type = "ubuntu"
+    _accessibility_hint = "Ubuntu accessibility tree is not supported yet"
+
+    def __init__(
+        self,
+        sandbox_id: str,
+        http: httpx.Client,
+        *,
+        vnc_url: str = "",
+        host: str = "",
+        version: str = "",
+    ):
+        super().__init__(sandbox_id, SandboxType.UBUNTU, http, vnc_url=vnc_url)
+        self.host = host
+        self.version = version
+        self.mouse = Mouse(http, self._prefix)
+        self.keyboard = Keyboard(http, self._prefix)
+        self.shell = Shell(http, self._prefix, default_shell="bash")
+
+    def act(
+        self,
+        action: dict,
+        screenshot_after: bool = True,
+        screenshot_delay_ms: int = 100,
+    ) -> ActResult:
+        resp = self._http.post(
+            f"{self._prefix}/act",
+            json={
+                "action": action,
+                "screenshot_after": screenshot_after,
+                "screenshot_delay_ms": screenshot_delay_ms,
+            },
+        )
+        resp.raise_for_status()
+        if screenshot_after and resp.headers.get("content-type", "").startswith("image/"):
+            return ActResult(screenshot=resp.content)
+        return ActResult(data=resp.json())
+
+    def run(self, command: str, shell: ShellKind | None = None, timeout: int = 300) -> ExecResult:
+        """Shorthand for self.shell.run()."""
+        return self.shell.run(command, shell, timeout)
+
+
 # ---------------------------------------------------------------------------
 # Async
 # ---------------------------------------------------------------------------
@@ -497,6 +552,9 @@ class AsyncIOSSandbox(AsyncSandbox):
 class AsyncWindowsSandbox(_NoAxeAccessibility, AsyncSandbox):
     """Async Windows VM sandbox — see WindowsSandbox."""
 
+    _accessibility_sandbox_type = "windows"
+    _accessibility_hint = "use .ui_tree() for the native Windows UIAutomation tree"
+
     def __init__(
         self,
         sandbox_id: str,
@@ -504,9 +562,11 @@ class AsyncWindowsSandbox(_NoAxeAccessibility, AsyncSandbox):
         *,
         vnc_url: str = "",
         host: str = "",
+        version: str = "",
     ):
         super().__init__(sandbox_id, SandboxType.WINDOWS, http, vnc_url=vnc_url)
         self.host = host
+        self.version = version
         self.mouse = AsyncMouse(http, self._prefix)
         self.keyboard = AsyncKeyboard(http, self._prefix)
         self.shell = AsyncShell(http, self._prefix)
@@ -543,3 +603,51 @@ class AsyncWindowsSandbox(_NoAxeAccessibility, AsyncSandbox):
         )
         resp.raise_for_status()
         return resp.json()
+
+
+class AsyncUbuntuSandbox(_NoAxeAccessibility, AsyncSandbox):
+    """Async Ubuntu desktop VM sandbox — see UbuntuSandbox."""
+
+    _accessibility_sandbox_type = "ubuntu"
+    _accessibility_hint = "Ubuntu accessibility tree is not supported yet"
+
+    def __init__(
+        self,
+        sandbox_id: str,
+        http: httpx.AsyncClient,
+        *,
+        vnc_url: str = "",
+        host: str = "",
+        version: str = "",
+    ):
+        super().__init__(sandbox_id, SandboxType.UBUNTU, http, vnc_url=vnc_url)
+        self.host = host
+        self.version = version
+        self.mouse = AsyncMouse(http, self._prefix)
+        self.keyboard = AsyncKeyboard(http, self._prefix)
+        self.shell = AsyncShell(http, self._prefix, default_shell="bash")
+
+    async def act(
+        self,
+        action: dict,
+        screenshot_after: bool = True,
+        screenshot_delay_ms: int = 100,
+    ) -> ActResult:
+        resp = await self._http.post(
+            f"{self._prefix}/act",
+            json={
+                "action": action,
+                "screenshot_after": screenshot_after,
+                "screenshot_delay_ms": screenshot_delay_ms,
+            },
+        )
+        resp.raise_for_status()
+        if screenshot_after and resp.headers.get("content-type", "").startswith("image/"):
+            return ActResult(screenshot=resp.content)
+        return ActResult(data=resp.json())
+
+    async def run(
+        self, command: str, shell: ShellKind | None = None, timeout: int = 300
+    ) -> ExecResult:
+        """Shorthand for self.shell.run()."""
+        return await self.shell.run(command, shell, timeout)

{use_computer-0.0.22 → use_computer-0.0.24}/use_computer/windows/shell.py

@@ -6,20 +6,21 @@ import httpx
 
 from use_computer.models import ExecResult
 
-ShellKind = Literal["powershell", "cmd"]
+ShellKind = Literal["bash", "sh", "powershell", "cmd"]
 
 
 class Shell:
     """Run commands inside a Windows sandbox via the in-guest agent (no SSH)."""
 
-    def __init__(self, http: httpx.Client, prefix: str):
+    def __init__(self, http: httpx.Client, prefix: str, default_shell: ShellKind = "powershell"):
         self._http = http
         self._prefix = prefix
+        self._default_shell = default_shell
 
-    def run(self, command: str, shell: ShellKind = "powershell", timeout: int = 300) -> ExecResult:
+    def run(self, command: str, shell: ShellKind | None = None, timeout: int = 300) -> ExecResult:
         resp = self._http.post(
             f"{self._prefix}/exec",
-            json={"command": command, "shell": shell},
+            json={"command": command, "shell": shell or self._default_shell},
             timeout=timeout,
         )
         resp.raise_for_status()
@@ -35,16 +36,19 @@ class Shell:
 class AsyncShell:
     """Async variant of Shell."""
 
-    def __init__(self, http: httpx.AsyncClient, prefix: str):
+    def __init__(
+        self, http: httpx.AsyncClient, prefix: str, default_shell: ShellKind = "powershell"
+    ):
         self._http = http
         self._prefix = prefix
+        self._default_shell = default_shell
 
     async def run(
-        self, command: str, shell: ShellKind = "powershell", timeout: int = 300
+        self, command: str, shell: ShellKind | None = None, timeout: int = 300
     ) -> ExecResult:
         resp = await self._http.post(
             f"{self._prefix}/exec",
-            json={"command": command, "shell": shell},
+            json={"command": command, "shell": shell or self._default_shell},
             timeout=timeout,
         )
         resp.raise_for_status()

use_computer-0.0.22/examples/_1_hello_macos.py

@@ -1,8 +0,0 @@
-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.22/examples/_2_hello_ios.py

@@ -1,11 +0,0 @@
-from use_computer import Computer, SandboxType, SimulatorFamily
-
-# iPhone is the default when family= is omitted. Pass family= to target a
-# different simulator family (iPad, Apple Watch, Apple TV, Apple Vision); the
-# SDK picks a compatible installed device_type + runtime pair for you. See
-# _6_hello_tvos.py for an Apple TV walkthrough.
-with Computer().create(type=SandboxType.IOS, family=SimulatorFamily.IPHONE) 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.22/examples/_3_recording.py

@@ -1,10 +0,0 @@
-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.22/examples/_4_file_transfer.py

@@ -1,7 +0,0 @@
-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.22/examples/_5_keepalive.py

@@ -1,9 +0,0 @@
-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.22/examples/_6_hello_tvos.py

@@ -1,11 +0,0 @@
-from use_computer import Computer, RemoteButton, SandboxType, SimulatorFamily
-
-# tvOS sims have no touch — drive them with the remote (D-pad + select / menu /
-# home). `press_remote` accepts the enum or a string.
-with Computer().create(type=SandboxType.IOS, family=SimulatorFamily.TV) as tv:
-    tv.input.press_remote(RemoteButton.DOWN)
-    tv.input.press_remote(RemoteButton.DOWN)
-    tv.input.press_remote(RemoteButton.SELECT)
-    png = tv.screenshot.take_full_screen()
-    open("hello_tvos.png", "wb").write(png)
-    print(f"saved hello_tvos.png ({len(png)} bytes)")

use_computer-0.0.22/examples/_7_hello_windows.py

@@ -1,11 +0,0 @@
-from use_computer import Computer
-
-# Beta: Windows sandboxes. No SSH — exec runs in-guest via PowerShell/cmd.
-with Computer().create(type="windows") as win:
-    win.run("Start-Process notepad")  # PowerShell by default
-    win.keyboard.type("hello from use.computer")
-    print(win.run("$env:COMPUTERNAME", shell="powershell").stdout)
-
-    png = win.screenshot.take_full_screen()
-    open("hello_windows.png", "wb").write(png)
-    print(f"saved hello_windows.png ({len(png)} bytes)")

use_computer-0.0.22/examples/go/hello_windows.go

@@ -1,35 +0,0 @@
-// Windows (Beta). Run:
-//   export USE_COMPUTER_API_KEY=...
-//   go run hello_windows.go
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-
-	uc "github.com/josancamon19/use-computer-sdk/go"
-)
-
-func main() {
-	ctx := context.Background()
-	c := uc.New()
-
-	win, err := c.Create(ctx, uc.CreateOptions{Type: uc.Windows, Version: "windows-11"})
-	if err != nil {
-		panic(err)
-	}
-	defer win.Close(ctx)
-
-	name, _ := win.RunShell(ctx, "$env:COMPUTERNAME", "powershell")
-	fmt.Println("computer name:", name.Stdout)
-	win.RunShell(ctx, "Start-Process notepad", "powershell")
-	win.TypeText(ctx, "hello from use.computer")
-
-	png, err := win.Screenshot(ctx)
-	if err != nil {
-		panic(err)
-	}
-	os.WriteFile("hello_windows.png", png, 0o644)
-	fmt.Printf("saved hello_windows.png (%d bytes)\n", len(png))
-}

use_computer-0.0.22/examples/javascript/hello_windows.ts

@@ -1,14 +0,0 @@
-// Windows (Beta) — run: USE_COMPUTER_API_KEY=... npx tsx hello_windows.ts
-import { Computer } from "use-computer";
-
-const computer = new Computer();
-await using win = await computer.create({ type: "windows", version: "windows-11" });
-
-console.log("computer name:", (await win.run("$env:COMPUTERNAME")).stdout.trim());
-await win.run("Start-Process notepad");
-await win.keyboard.type("hello from use.computer");
-
-const png = await win.screenshot.takeFullScreen();
-const { writeFile } = await import("node:fs/promises");
-await writeFile("hello_windows.png", png);
-console.log(`saved hello_windows.png (${png.length} bytes)`);

use_computer-0.0.22/go/README.md

@@ -1,46 +0,0 @@
-# use-computer — Go SDK
-
-Go client for [use.computer](https://use.computer) — rent dedicated VMs (macOS, iOS/visionOS/tvOS simulators, **Windows**, **Ubuntu**) built for computer-use agents. Parity with the [Python](../python) and [TypeScript](../javascript) SDKs.
-
-```bash
-go get github.com/josancamon19/use-computer-sdk/go@latest
-export USE_COMPUTER_API_KEY=mk_live_...
-```
-
-```go
-package main
-
-import (
-	"context"
-	"fmt"
-
-	uc "github.com/josancamon19/use-computer-sdk/go"
-)
-
-func main() {
-	ctx := context.Background()
-	c := uc.New() // base URL + key from env, or uc.WithBaseURL/WithAPIKey
-
-	// Windows (Beta) — no SSH; runs in-guest via PowerShell/cmd
-	win, err := c.Create(ctx, uc.CreateOptions{Type: uc.Windows, Version: "windows-11"})
-	if err != nil {
-		panic(err)
-	}
-	defer win.Close(ctx)
-
-	r, _ := win.RunShell(ctx, "$env:COMPUTERNAME", "powershell")
-	fmt.Println(r.Stdout)
-	win.Click(ctx, 400, 300)
-	win.TypeText(ctx, "hello from use.computer")
-	png, _ := win.Screenshot(ctx)
-	fmt.Printf("screenshot %d bytes\n", len(png))
-}
-```
-
-## Surface
-
-- `New(opts...)` → `*Computer`; `WithBaseURL`, `WithAPIKey`, `WithHTTPClient`.
-- `Create(ctx, CreateOptions{Type, Version, Host, Family, DeviceType, Runtime})` → `*Sandbox`.
-- `Sandbox`: `Exec` (SSH on macOS / in-guest on Ubuntu / PowerShell on Windows), `RunShell(cmd, "powershell"|"cmd")`, `Screenshot`, `Click`, `Move`, `Scroll`, `TypeText`, `PressKey`, `Hotkey`, `UITree`, `Upload`, `Download`, `StartRecording`/`StopRecording`, `Keepalive`, `Close`.
-
-Every call takes a `context.Context`. Docs: [docs.use.computer](https://docs.use.computer). Windows is **Beta** (admin-only).