OpenSandbox Documentation

Secure, Fast, and Extensible Sandbox runtime for AI agents.

16,044 stars Python Python 101 files ยท ~259,064 tokens #ai#ai-agent#ai-infra#kubernetes#sandbox
RAW Doc

File: docs/index.md


layout: home

hero:
name: OpenSandbox
text: Universal Sandbox Infrastructure for AI Applications
tagline: Securely run commands, code interpreters, browsers, and developer tools in isolated environments with multi-language SDKs.
actions:
- theme: brand
text: Quick Start
link: /getting-started/
- theme: alt
text: Architecture
link: /architecture/
- theme: alt
text: SDKs
link: /sdks/

features:

  • title: Sandbox Lifecycle Management
    details: Provision, monitor, renew, pause/resume, and terminate sandbox instances with Docker and Kubernetes runtimes.
  • title: Multi-Language SDKs
    details: Build with Python, Java/Kotlin, JavaScript/TypeScript, C#/.NET, and Go SDKs on top of standardized lifecycle and execution protocols.
  • title: In-Sandbox Execution
    details: Execute shell commands, manage files, run multi-language code interpreters, expose ports, and stream logs and metrics.
  • title: Built for AI Workloads
    details: Supports coding agents, browser automation, remote development, code execution, and reinforcement learning scenarios.

Typical Scenarios

OpenSandbox is listed in the CNCF Landscape.

Coding Agents

Run Claude Code, Gemini CLI, Codex, and other coding agents in isolated sandboxes.

Browser Automation

Execute Chrome and Playwright workloads with controlled runtime, filesystem, and networking.

Remote Development

Host VS Code Web and desktop-like environments for secure cloud development workflows.

AI Code Execution

Run model-generated code safely, stream outputs, and iterate quickly with reproducible environments.

Explore all examples in Examples.

Quick Install

::: code-group

bash [python sdk]
pip install opensandbox
bash [javascript sdk]
npm install @alibaba-group/opensandbox
kotlin [kotlin (gradle)]
dependencies {
    implementation("com.alibaba.opensandbox:sandbox:{latest_version}")
}
bash [go sdk]
go get github.com/alibaba/OpenSandbox/sdks/sandbox/go
bash [c# sdk]
dotnet add package Alibaba.OpenSandbox

:::

See Getting Started for the full setup guide.


File: docs/README.md

OpenSandbox Docs Site

This directory hosts the VitePress site for OpenSandbox.

Local development

bash
nvm use 22
cd docs
pnpm install
pnpm docs:dev

Build

bash
nvm use 22
cd docs
pnpm install
pnpm docs:build

Notes

  • Site content is maintained directly under docs/ โ€” not auto-generated from monorepo READMEs.
  • See AGENTS.md โ†’ "Documentation Rules" for content ownership and conventions.