Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

docs: Cua Bots and create_space describe your own computers, cloud account or sandbox provider (#5529)

Francesco Bonacci98bd4c9f70ef
diff --git a/docs/content/docs/spaces/examples/cua-bots.mdx b/docs/content/docs/spaces/examples/cua-bots.mdx
index c0dfb8a892..5ca8dd983e 100644
--- a/docs/content/docs/spaces/examples/cua-bots.mdx
+++ b/docs/content/docs/spaces/examples/cua-bots.mdx
@@ -22,7 +22,7 @@ Cua Bots is an example app for persistent bots. You create a bot, give it a name
## Features
-- Create a bot in three steps: name it, design its face (color, eyes, ears), and choose which of your computers it runs on (This Mac or a computer you [added](/spaces/guides/add-a-computer)) and which agent drives it (Hermes, OpenClaw, Codex or Claude Code). It introduces itself when its computer is up.
+- Create a bot in three steps: name it, design its face (color, eyes, ears), and choose which of your computers it runs on (This Mac, a computer you [added](/spaces/guides/add-a-computer), your own cloud account such as AWS or Google Cloud, or a sandbox provider such as E2B, Daytona or Modal) and which agent drives it (Hermes, OpenClaw, Codex or Claude Code). It introduces itself when its computer is up.
- Its face changes with what it's doing: thinking, working, waiting for you, done or paused.
- "Ada's computer": the bot's own Space, live beside the chat, framed in its color, with picture in picture. The bot has control until you take over; its face rides next to its pointer.
- Memory in the Cua Volume layout at `agents/<name>/`: it outlives the bot's computer. Finished files land in `outputs/`, files you hand it in `inbox/`.
diff --git a/docs/content/docs/spaces/reference/spaces.mdx b/docs/content/docs/spaces/reference/spaces.mdx
index ca2e656d8c..18278ac46e 100644
--- a/docs/content/docs/spaces/reference/spaces.mdx
+++ b/docs/content/docs/spaces/reference/spaces.mdx
@@ -137,7 +137,7 @@ Creates a new sandbox where `on` says (local: this computer, free; aws, gcp or m
| `image` | `string` | none | Guest image. Default: the canonical Linux image (`ghcr.io/trycua/linux:24.04`), whose variant follows the kind. |
| `kind` | `"auto" \| "container" \| "vm"` | `auto` | What kind of computer. Default `auto` (from the image). `auto`: From the image: macOS and Windows images are VMs, an image with a container rootfs is a container, a disk-only image is a VM. `container`: A container (gVisor, or runc locally). `vm`: A virtual machine (QEMU or Lume locally, KubeVirt in the cloud). |
| `name` | `string` | none | Name. Default: a generated `space-<hex>`. |
-| `on` | `string` | none | Where it runs: `local` (this computer, free), `cloud` (Cua cloud, metered), or `host:<computer>`: one of the user's own computers that provides Spaces (`cua host setup --provide-spaces` on it), named by id or by words from its name ("host:spare mac mini" matches "Mac mini (spare)" or `dillons-mac-mini`). Default: the user's default location (`cua config set default.on`, `CUA_DEFAULT_ON`), else `local`. Not `direct:<addr>`: that is one already-running Space at a fixed address, attached with `add_space`, not a host this can create on. An existing computer is added with `add_space`, not created. |
+| `on` | `string` | none | Where it runs: `local` (this computer, free), `aws`, `gcp` or `modal` (your own cloud account, billed there), or `host:<computer>`: one of the user's own computers that provides Spaces (`cua host setup --provide-spaces` on it), named by id or by words from its name ("host:spare mac mini" matches "Mac mini (spare)" or `dillons-mac-mini`). Default: the user's default location (`cua config set default.on`, `CUA_DEFAULT_ON`), else `local`. Not `direct:<addr>`: that is one already-running Space at a fixed address, attached with `add_space`, not a host this can create on. An existing computer is added with `add_space`, not created. |
| `reuse` | `boolean` | `false` | Return a reachable registered Space in the same location that has the requested services instead of creating one (get-or-create). Default false. |
| `runtime` | `string` | `auto` | Which engine. Default `auto`: the safest one for the location and kind. Local: `gvisor` or `runc` (containers), `qemu` or `lume` (VMs). Cloud: `gvisor` (containers), `kubevirt` (VMs). Anything else fails with `invalid_placement`, listing the valid values. |
| `services` | `map of integer` | none | Named services (name to guest port), for example `{"mcp": 8765}`. Each is probed for readiness and reachable with `list_tools` / `call_tool` (`service=<name>`). |
diff --git a/libs/cua/crates/cua-spaces-contract/src/inputs.rs b/libs/cua/crates/cua-spaces-contract/src/inputs.rs
index c95860be56..d1775025f6 100644
--- a/libs/cua/crates/cua-spaces-contract/src/inputs.rs
+++ b/libs/cua/crates/cua-spaces-contract/src/inputs.rs
@@ -137,8 +137,8 @@ pub struct CreateSpace {
/// (`ghcr.io/trycua/linux:24.04`), whose variant follows the kind.
#[serde(default)]
pub image: Option<String>,
- /// Where it runs: `local` (this computer, free), `cloud` (Cua cloud,
- /// metered), or `host:<computer>`: one of the user's own computers that
+ /// Where it runs: `local` (this computer, free), `aws`, `gcp` or `modal` (your own
+ /// cloud account, billed there), or `host:<computer>`: one of the user's own computers that
/// provides Spaces (`cua host setup --provide-spaces` on it), named by
/// id or by words from its name ("host:spare mac mini" matches "Mac
/// mini (spare)" or `dillons-mac-mini`). Default: the user's default
diff --git a/libs/cua/spaces-contract/manifest.json b/libs/cua/spaces-contract/manifest.json
index c330aa4198..72d95ada4f 100644
--- a/libs/cua/spaces-contract/manifest.json
+++ b/libs/cua/spaces-contract/manifest.json
@@ -491,7 +491,7 @@
"type": "string"
},
"on": {
- "description": "Where it runs: `local` (this computer, free), `cloud` (Cua cloud,\nmetered), or `host:<computer>`: one of the user's own computers that\nprovides Spaces (`cua host setup --provide-spaces` on it), named by\nid or by words from its name (\"host:spare mac mini\" matches \"Mac\nmini (spare)\" or `dillons-mac-mini`). Default: the user's default\nlocation (`cua config set default.on`, `CUA_DEFAULT_ON`), else\n`local`. Not `direct:<addr>`: that is one already-running Space at a\nfixed address, attached with `add_space`, not a host this can create\non. An existing computer is added with `add_space`, not created.",
+ "description": "Where it runs: `local` (this computer, free), `aws`, `gcp` or `modal` (your own\ncloud account, billed there), or `host:<computer>`: one of the user's own computers that\nprovides Spaces (`cua host setup --provide-spaces` on it), named by\nid or by words from its name (\"host:spare mac mini\" matches \"Mac\nmini (spare)\" or `dillons-mac-mini`). Default: the user's default\nlocation (`cua config set default.on`, `CUA_DEFAULT_ON`), else\n`local`. Not `direct:<addr>`: that is one already-running Space at a\nfixed address, attached with `add_space`, not a host this can create\non. An existing computer is added with `add_space`, not created.",
"type": "string"
},
"reuse": {