# raw.computer

> Full Linux virtual machines ("sandboxes") for AI agents, CI and developers: systemd, Docker, nested virtualization, persistent disks, snapshots and forks. Billed per second with no start fees; when cells are full a start queues with an ETA instead of failing.

Early access: accounts, API keys, members and the wallet work; no cell is open to customers yet, so creating a sandbox answers 503 `capacity_unavailable`. Sandboxes, snapshots and templates are listed from the directory the cells report to (`GET /v1/sandboxes`, `/v1/snapshots`, `/v1/templates`; our public templates have `workspace: null`), empty until a cell reports. Every docs page is available as Markdown by adding `.md` to its URL. The HTTP API lives at https://raw.computer/v1 and is described by its OpenAPI 3.1 document. Every error carries `next_step`.

## Docs

- [Introduction](https://raw.computer/docs/introduction.md): What raw.computer is, who it is for, and where to start.
- [Quickstart](https://raw.computer/docs/quickstart.md): Sign up, install the raw CLI, sign in, and create your first sandbox; or do the same with curl and an API key.
- [Concepts](https://raw.computer/docs/concepts.md): Orgs, workspaces, keys, sandboxes, snapshots, templates, sizes, classes, cells, the queue and residency.
- [API](https://raw.computer/docs/api.md): Base URL, authentication, versions, idempotency, ids, lists, money and the error shape of the raw.computer API, and every endpoint it answers today.
- [Errors](https://raw.computer/docs/errors.md): Every error code the raw.computer API returns, what it means, and the next step.
- [CLI](https://raw.computer/docs/cli.md): Install the raw command-line tool, sign in through the browser, and run every command, in words or as JSON.
- [SDKs](https://raw.computer/docs/sdks.md): The TypeScript and Python SDKs: every API operation as a typed method, with the version, idempotency, retries and typed errors built in.
- [Agents](https://raw.computer/docs/agents.md): The raw-computer skill, the raw MCP server, and raw agent setup, which connects both to Claude Code, Codex and Cursor.
- [Pricing](https://raw.computer/docs/pricing.md): Every raw.computer price, how compute and storage are billed, and what you pay when a sandbox is stopped.
- [Limits](https://raw.computer/docs/limits.md): The sizes each class sells, request limits, what works during early access, and budgets.
- [Benchmarks](https://raw.computer/docs/benchmarks.md): How raw.computer will measure speed before publishing any number, and what each measurement means.

## API

- [OpenAPI 3.1 document](https://raw.computer/v1/openapi.json): every endpoint, request and response of /v1
- [A workspace's people and settings](https://raw.computer/docs/api.md): an admin's personal token (`rc_pat_`, from `raw login`) invites, lists and withdraws invitations, changes a member's relation, removes a member, renames the workspace and sets its residency; a workspace key (`rc_live_`) is never an admin. An org's owners and name, new workspaces, the monthly caps and accepting an invitation are done only in the console.

## CLI

- [raw CLI](https://raw.computer/docs/cli.md): one binary; install with `curl -fsSL https://raw.computer/install.sh | sh`, sign in with `raw login`, and every command takes `--json` (the API's own JSON on stdout, the exit status 0, 1 or 2). In CI set RAW_API_KEY, or RAW_TOKEN with RAW_WORKSPACE.
- [Newest release](https://raw.computer/cli/latest.json): its version and, per OS and architecture, the URL and sha256 of its build

## SDKs

- [SDKs](https://raw.computer/docs/sdks.md): TypeScript and Python, both `rawcomputer`, generated from the OpenAPI document: every operation a typed method, Raw-Version, Idempotency-Key, retries by Retry-After and one typed RawError built in. Not on npm or PyPI yet; until then call the API or use the CLI.
- [SDKs, in Chinese](https://raw.computer/docs/sdks.md?lang=zh): the same page in Chinese (中文)

## Agents

- [Agents](https://raw.computer/docs/agents.md): the raw-computer skill, the MCP server `raw mcp` (the CLI's commands as tools, answering in the API's JSON), and `raw agent setup`, which writes both into Claude Code, Codex and Cursor
- [The raw-computer skill](https://raw.computer/.well-known/agent-skills/raw-computer/SKILL.md): signing in, the budget's `can_start`, creating sandboxes, Idempotency-Key, `next_step` and `capacity_unavailable`; install it with `npx skills add https://raw.computer` (the index: https://raw.computer/.well-known/agent-skills/index.json)
- [Agents, in Chinese](https://raw.computer/docs/agents.md?lang=zh): the same page in Chinese (中文)

## Optional

- [All docs in one file](https://raw.computer/llms-full.txt): every page above, concatenated
- [Pricing](https://raw.computer/pricing): price list, calculator and a comparison with other providers, with sources