OpenSandbox: contracts, control, execution, and security

OpenSandbox: contracts, control, execution, and security An architecture diagram generated by Archify. Sandbox SDKs · Python, JS/TS, Java, C#, Go · Client entry points Sandbox SDKs Python, JS/TS, Java, C#, Go osb CLI + MCP server · Operator and agent tools · Client entry points osb CLI + MCP server Operator and agent tools sandbox-lifecycle.yml · Lifecycle API contract · Public OpenAPI contracts sandbox-lifecycle.yml Lifecycle API contract diagnostic-api.yml · Diagnostic API contract · Public OpenAPI contracts diagnostic-api.yml Diagnostic API contract execd-api.yaml · Command and file API contract · Public OpenAPI contracts execd-api.yaml Command and file API contract egress-api.yaml · Egress policy API contract · Public OpenAPI contracts egress-api.yaml Egress policy API contract FastAPI lifecycle server · Authentication, config, validation · Lifecycle control plane FastAPI lifecycle server Authentication, config, validation Lifecycle services · SandboxService, SnapshotService, pools · Lifecycle control plane Lifecycle services SandboxService, SnapshotService, pools Lifecycle state · SQLite storage and renew intents · Lifecycle control plane Lifecycle state SQLite storage and renew intents Docker runtime · Local containers; ports, volumes, snapshots · Alternative runtime backends Docker runtime Local containers; ports, volumes, snapshots Kubernetes runtime · BatchSandbox / Pool; sandbox provider · Alternative runtime backends Kubernetes runtime BatchSandbox / Pool; sandbox provider User workload · User image and entrypoint · Sandbox data plane: user image + injected control processes User workload User image and entrypoint execd service · Commands, files, PTY, sessions, metrics · Sandbox data plane: user image + injected control processes execd service Commands, files, PTY, sessions, metrics Volumes · Host mounts, PVC, OSSFS · Sandbox data plane: user image + injected control processes Volumes Host mounts, PVC, OSSFS Jupyter kernels · Interactive code execution · Sandbox data plane: user image + injected control processes Jupyter kernels Interactive code execution Ingress gateway · Header routing; validate access · Network and security plane Ingress gateway Header routing; validate access Server proxy · HTTP and WebSocket · Network and security plane Server proxy HTTP and WebSocket Secure access · Short-lived signed routes · Network and security plane Secure access Short-lived signed routes Egress sidecar · Per-Sandbox outbound policy · Network and security plane Egress sidecar Per-Sandbox outbound policy Secure runtime · gVisor, Kata, Firecracker · Network and security plane Secure runtime gVisor, Kata, Firecracker Runtime backend dispatch · Choose Docker or Kubernetes · Alternative runtime backends Runtime backend dispatch Choose Docker or Kubernetes API API Validate Dispatch Provision instance Execute Kernels Files Forward Authenticated access Validate route Egress policy Optional isolation Client entry points Public OpenAPI contracts Lifecycle control plane Alternative runtime backends Sandbox data plane: user image + injected control processes Network and security plane Legend Control / execution services Storage / volumes Runtime backends Network / isolation controls Clients / protocol contracts