OpenSandbox
安全、快速且可擴展的 Sandbox 執行環境,專為 AI 代理人設計。
OpenSandbox 是什麼?
OpenSandbox 提供安全、快速且可擴展的 Sandbox 執行環境,專為 AI 代理人設計。
OpenSandbox 概覽
這是什麼
OpenSandbox 是一個 Agentic AI Foundation (AAIF) 專案,為 AI 應用提供隔離的環境來執行程式碼、執行指令、管理檔案,以及操作瀏覽器或桌面。可以透過統一的沙箱 API 在本機使用 Docker 啟動,並部署到 Kubernetes 上。
主要功能
- 快速沙箱執行環境:Firecracker 建立時間為 64 ms P50(序列)與 125.4 ms P99(10 個並行)。支援暫停/恢復,保留記憶體與磁碟狀態。
- 代理工作環境:透過內建 API 執行指令、管理檔案與執行程式碼。整合範例包含程式碼代理、瀏覽器與桌面。
- 網路存取控制:透過統一的入口閘道路由入站流量,並以每個沙箱的出口政策控制出站存取。
- 憑證保管庫:讓代理呼叫外部服務時,不向沙箱工作負載暴露真實憑證。
- 從本機到叢集:透過統一的生命週期 API 從 Docker 開始,再部署到 Kubernetes。資源池與批次建立支援代理評估與強化學習訓練工作負載。
- SDK、CLI 與 MCP:整合 Python、Java/Kotlin、TypeScript/JavaScript、C#/.NET 或 Go SDK。從終端機使用
osb,或透過 MCP 連接代理。 - 可擴展沙箱協定:針對定義的沙箱生命週期與執行 API 建立自訂執行環境整合。
使用情境
- 程式碼代理:在隔離環境中執行程式碼代理,以編輯檔案、執行指令並完成開發任務(例如 Claude Code、Codex CLI、DeerFlow)。
- 程式碼執行與資料分析:執行模型生成的程式碼,並透過 Code Interpreter SDK 處理結果。
- 瀏覽器與桌面自動化:自動化網頁互動與測試,或讓代理存取桌面環境(例如 Playwright、Chrome、Desktop)。
- 代理評估:為每次試驗使用獨立的沙箱執行評估(例如 Harbor Evaluation)。
快速開始
需求:Docker、Python 3.10+
安裝並設定沙箱伺服器:
uvx opensandbox-server init-config ~/.sandbox.toml --example docker
uvx opensandbox-server
安裝 Sandbox SDK:
uv pip install opensandbox
建立沙箱並執行指令(Python 範例):
import asyncio
from opensandbox import Sandbox
async def main():
sandbox = await Sandbox.create("alpine")
try:
execution = await sandbox.commands.run("echo 'Hello OpenSandbox!'")
print(execution.logs.stdout[0].text)
finally:
await sandbox.destroy()
asyncio.run(main())
授權與價格
Apache-2.0 授權。開放原始碼。未提及價格資訊。
內容整理自該專案公開的 README 與儲存庫資訊。