perplexityai / SPACE

# SPACE
Guide · API Reference
SPACE (Sandboxed Platform for Agentic Code Execution) is a sandbox platform for running code in isolated Firecracker microVMs. Applications use its HTTP API to create Linux environments, execute commands, collect output, and manage sandbox lifecycles.
Use SPACE when your application needs a separate execution environment for an agent, a user workspace, or a code-running job. Your application decides what to run and what results to keep; SPACE manages the sandbox, its processes, and the connection carrying command output.
## How it works
A **template** supplies the starting environment. A **sandbox** is an instance of that environment with its own VM and writable filesystem; multiple commands can run in the same sandbox.
 [code] 
Sandbox lifecycle changes are asynchronous: the API returns an operation ID that you poll for completion. Command output uses a separate data-plane connection and a session-scoped attachment token.
## Get started
Follow Installation and configuration to deploy SPACE in a local Kind cluster and authenticate. Then follow Your first sandbox to run a command and collect its output. The setup guide covers Kubernetes; the architecture guide also explains how SPACE can run without it.
## Documentation
Read the hosted Guide and API Reference online. Both update automatically after changes merge. The links below point to source documentation in this checkout.
| Guide | What you will learn |
|---|---|
| Versioning and compatibility | Release progression, supported guests, service stability, and upgrade/rollback requirements. |
| Architecture | How templates, sandboxes, processes, sessions, and operations relate; what pause and suspend preserve; how the services fit together. |
| Installation and configuration | Host prerequisites, local Kind deployment, configuration defaults, authentication, verification, and teardown. |
| Operator CLI | API access, port forwarding, `space-admin-cli login`, nodes, warm pools, and system-template builds. |
| Your first sandbox | A complete API workflow, command customization, output handling, inspection, and deletion. |
| E2B Compatibility Wrapper | Configure ECW, create a compatibility API key, use the tested E2B Python SDK, and understand supported behavior and limitations. |
| API reference | Endpoints, request and response fields, and examples. |
| Troubleshooting | Local setup, authentication, lifecycle operations, command streams, and safe retries. |
| Operator egress profiles | Configure named policy additions for federated native and ECW creates. |
| Observability | Telemetry build features, the Rust/Go selector contract, and unchanged image defaults. |
| Warm pools | Keep booted sandboxes ready on Kubernetes so creates skip a cold boot. |
| Base snapshots | Restore sandboxes from a snapshot on a single node, optionally with a node warm pool. |
### Build documentation locally
To browse the guide and API together locally, install mdBook 0.4.52 and the API build