OpenSandbox Architecture
Four-layer design: SDKs, Specs, Runtime, and Sandbox Instances
Layer 1 : Multi-Language SDKs
Python
opensandbox
TypeScript
@alibaba-group
Java / Kotlin
JVM SDK
C# / .NET
NuGet
Go
Roadmap
MCP
Tool Protocol
Layer 2 : OpenAPI Specifications
Sandbox Lifecycle API
Sandbox Execution API (execd)
Layer 3 : Runtime (Server + Orchestration)
FastAPI Server
Lifecycle Manager
Auth, TTL, Provisioning
Docker Runtime
Local Development
Host / Bridge Mode
Kubernetes Runtime
Production Scale
CRDs + Operator
Network Layer
Ingress Gateway
Egress Controller
Layer 4 : Sandbox Instances (Containers)
Code Interpreter
execd (Go daemon)
Jupyter Kernels
Python
Node.js
Java
Bash
Browser / GUI
execd (Go daemon)
Chromium + VNC
Playwright Runtime
DevTools Protocol
Coding Agent
execd (Go daemon)
Claude Code
Gemini CLI / Codex
VS Code Server
RL Training
execd (Go daemon)
Training Loop
Checkpoints
Metrics Streaming
gVisor / Kata / Firecracker
Interactive Diagram:
Hover over any component to see its role in the OpenSandbox architecture.