# Sandbox as a Service

> Secure, disposable cloud sandboxes for AI agents and code execution. Each sandbox is a
> dedicated virtual machine, created with one API call and destroyed when you are done.

## What it does

- Create an isolated sandbox VM: POST https://sandbox-as-a-service.com/v1/sandboxes
- Run a shell command inside it: POST https://sandbox-as-a-service.com/v1/sandboxes/{id}/exec
- Extend its lifetime: POST https://sandbox-as-a-service.com/v1/sandboxes/{id}/extend
- Write a file into it: PUT https://sandbox-as-a-service.com/v1/sandboxes/{id}/files
- Read a file back out: GET https://sandbox-as-a-service.com/v1/sandboxes/{id}/files?path=out.txt
- List what a run produced: GET https://sandbox-as-a-service.com/v1/sandboxes/{id}/files?path=/workspace&list=true
- Destroy it: DELETE https://sandbox-as-a-service.com/v1/sandboxes/{id}
- Inspect one execution: GET https://sandbox-as-a-service.com/v1/executions/{id}
- Check balance, limits and pricing: GET https://sandbox-as-a-service.com/v1/account
- Check usage over a period: GET https://sandbox-as-a-service.com/v1/usage

Authentication: Authorization: Bearer aas_sk_... (create keys at https://sandbox-as-a-service.com/dashboard/keys)

## Pricing

Prepaid credit, billed for the time it runs, by the second — no minimum, no rounding up.
- small: 2 vCPU, 4 GB RAM, 40 GB disk — $0.09/hour
- medium: 4 vCPU, 8 GB RAM, 80 GB disk — $0.28/hour
- large: 8 vCPU, 16 GB RAM, 160 GB disk — $0.55/hour
New accounts receive $5 of credit. No credit card required to start.

## Pre-installed in every sandbox

Python 3.12 (with requests, numpy, pandas), Node.js 22, git, curl, wget, jq, unzip,
gnupg, build-essential.

Your code runs as an unprivileged user, so "apt-get install" and a bare
"pip install" both fail — apt needs root, and the system Python is marked
externally-managed (PEP 668). Install into the sandbox user instead:

  pip install --user --break-system-packages <pkg>     # or: python3 -m venv .venv
  npm install <pkg>                                    # works as-is, no root needed

## MCP

An MCP server exposes the same operations as agent tools.
Install: npx -y https://sandbox-as-a-service.com/mcp.tgz  (needs AAS_API_KEY in the environment)
Docs: https://sandbox-as-a-service.com/docs/mcp

## Documentation

- Quickstart: https://sandbox-as-a-service.com/docs
- API reference (OpenAPI 3.0): https://sandbox-as-a-service.com/openapi.json
- Interactive reference: https://sandbox-as-a-service.com/docs/api
- Limits and measured startup times: https://sandbox-as-a-service.com/docs/limits
- Security model: https://sandbox-as-a-service.com/security