[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-9874":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":22,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":16,"starSnapshotCount":16,"syncStatus":32,"lastSyncTime":33,"discoverSource":34},9874,"OpenSandbox","alibaba\u002FOpenSandbox","alibaba","Secure, Fast, and Extensible Sandbox runtime for AI agents.","https:\u002F\u002Fopen-sandbox.ai",null,"Python",11115,895,45,49,0,543,43.86,"Apache License 2.0",false,"main",true,[24,25,26,27,28],"ai","ai-agent","ai-infra","kubernetes","sandbox","2026-06-12 02:02:13","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Flogo.svg\" alt=\"OpenSandbox logo\" width=\"150\" \u002F>\n\n  \u003Ch1>OpenSandbox\u003C\u002Fh1>\n\n  \u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F21828\" target=\"_blank\">\n      \u003Cimg src=\"https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F21828\" alt=\"alibaba%2FOpenSandbox | Trendshift\" style=\"width: 320px; height: 70px;\" width=\"320\" height=\"70\" \u002F>\n    \u003C\u002Fa>\n  \u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Falibaba\u002FOpenSandbox\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Falibaba\u002FOpenSandbox.svg?style=social\" alt=\"GitHub stars\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdeepwiki.com\u002Falibaba\u002FOpenSandbox\">\n    \u003Cimg src=\"https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg\" alt=\"Ask DeepWiki\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0.html\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache%202.0-blue.svg\" alt=\"license\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.bestpractices.dev\u002Fprojects\u002F12588\">\n    \u003Cimg src=\"https:\u002F\u002Fwww.bestpractices.dev\u002Fprojects\u002F12588\u002Fbadge\" alt=\"OpenSSF Best Practices\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fopensandbox\">\n    \u003Cimg src=\"https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fopensandbox.svg\" alt=\"PyPI version\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@alibaba-group%2Fopensandbox\">\n    \u003Cimg src=\"https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@alibaba-group%2Fopensandbox.svg\" alt=\"npm version\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Flandscape.cncf.io\u002F?item=orchestration-management--scheduling-orchestration--opensandbox\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCNCF-Landscape-0C66E4\" alt=\"CNCF Landscape\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fqr.dingtalk.com\u002Faction\u002Fjoingroup?code=v1,k1,A4Bgl5q1I1eNU\u002Fr33D18YFNrMY108aFF38V+r19RJOM=&_dt_no_comment=1&origin=11\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDingTalk-Join-0089FF?logo=dingtalk&logoColor=white\" alt=\"DingTalk\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Falibaba\u002FOpenSandbox\u002Factions\">\n    \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Falibaba\u002FOpenSandbox\u002Factions\u002Fworkflows\u002Freal-e2e.yml\u002Fbadge.svg?branch=main\" alt=\"E2E Status\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Falibaba\u002FOpenSandbox\u002Factions\">\n    \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Falibaba\u002FOpenSandbox\u002Factions\u002Fworkflows\u002Fkubernetes-nightly-build.yml\u002Fbadge.svg?branch=main\" alt=\"E2E Status\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n  \u003Chr \u002F>\n\u003C\u002Fdiv>\n\n[Documentation](https:\u002F\u002Fopen-sandbox.ai\u002F) | [中文文档](https:\u002F\u002Fopen-sandbox.ai\u002Fzh\u002F)\n\nOpenSandbox is a **general-purpose sandbox platform** for AI applications, offering multi-language SDKs, unified sandbox APIs, and Docker\u002FKubernetes runtimes for scenarios like Coding Agents, GUI Agents, Agent Evaluation, AI Code Execution, and RL Training.\n\nOpenSandbox is now listed in the [CNCF Landscape](https:\u002F\u002Flandscape.cncf.io\u002F?item=orchestration-management--scheduling-orchestration--opensandbox).\n\n## Features\n\n- **Multi-language SDKs**: Provides sandbox SDKs in Python, Java\u002FKotlin, JavaScript\u002FTypeScript, C#\u002F.NET, Go.\n- **Sandbox Protocol**: Defines sandbox lifecycle management APIs and sandbox execution APIs so you can extend custom sandbox runtimes.\n- **Sandbox Runtime**: Built-in lifecycle management supporting Docker and [high-performance Kubernetes runtime](.\u002Fkubernetes), enabling both local runs and large-scale distributed scheduling.\n- **Sandbox Environments**: Built-in Command, Filesystem, and Code Interpreter implementations. Examples cover Coding Agents (e.g., Claude Code), browser automation (Chrome, Playwright), and desktop environments (VNC, VS Code).\n- **Network Policy**: Unified [Ingress Gateway](components\u002Fingress) with multiple routing strategies plus per-sandbox [egress controls](components\u002Fegress).\n- **Strong Isolation**: Supports secure container runtimes like gVisor, Kata Containers, and Firecracker microVM for enhanced isolation between sandbox workloads and the host. See [Secure Container Runtime Guide](docs\u002Fsecure-container.md) for details.\n\n## SDKs\n\nPython:\n\n```bash\npip install opensandbox\n```\n\nJava\u002FKotlin (Gradle Kotlin DSL):\n\n```kotlin\ndependencies {\n    implementation(\"com.alibaba.opensandbox:sandbox:{latest_version}\")\n}\n```\n\nJava\u002FKotlin (Maven):\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.alibaba.opensandbox\u003C\u002FgroupId>\n    \u003CartifactId>sandbox\u003C\u002FartifactId>\n    \u003Cversion>{latest_version}\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\nJavaScript\u002FTypeScript:\n\n```bash\nnpm install @alibaba-group\u002Fopensandbox\n```\n\nC#\u002F.NET:\n\n```bash\ndotnet add package Alibaba.OpenSandbox\n```\n\nGo:\n\n```bash\ngo get github.com\u002Falibaba\u002FOpenSandbox\u002Fsdks\u002Fsandbox\u002Fgo\n```\n\n## CLI\n\nOpenSandbox also provides `osb`, a terminal CLI for the common sandbox workflow: create sandboxes, run commands, move files, inspect diagnostics, and manage runtime egress policy.\n\nInstall:\n\n```bash\npip install opensandbox-cli\n# or\nuv tool install opensandbox-cli\n```\n\nQuick start:\n\n```bash\nosb config init\nosb config set connection.domain localhost:8080\nosb config set connection.protocol http\nosb sandbox create --image python:3.12 --timeout 30m -o json\nosb command run \u003Csandbox-id> -o raw -- python -c \"print(1 + 1)\"\n```\n\nSee the [CLI README](cli\u002FREADME.md) for the full command reference.\n\n## MCP\n\nThe OpenSandbox MCP server exposes sandbox creation, command execution, and text file operations to MCP-capable clients such as Claude Code and Cursor.\n\nInstall and run:\n\n```bash\npip install opensandbox-mcp\nopensandbox-mcp --domain localhost:8080 --protocol http\n```\n\nMinimal stdio config:\n\n```json\n{\n  \"mcpServers\": {\n    \"opensandbox\": {\n      \"command\": \"opensandbox-mcp\",\n      \"args\": [\"--domain\", \"localhost:8080\", \"--protocol\", \"http\"]\n    }\n  }\n}\n```\n\nSee the [MCP README](sdks\u002Fmcp\u002Fsandbox\u002Fpython\u002FREADME.md) for client-specific setup.\n\n## Getting Started\n\nRequirements:\n\n- Docker (required for local execution)\n- Python 3.10+ (required for examples and local runtime)\n\n### Install and Configure the Sandbox Server\n\n```bash\nuvx opensandbox-server init-config ~\u002F.sandbox.toml --example docker\n\nuvx opensandbox-server\n\n# Show help\n# uvx opensandbox-server -h\n```\n\n### Create a Code Interpreter and Execute Commands\u002FCodes\n\nInstall the Code Interpreter SDK\n\n```bash\nuv pip install opensandbox-code-interpreter\n```\n\nCreate a sandbox and execute commands and codes.\n\n```python\nimport asyncio\nfrom datetime import timedelta\n\nfrom code_interpreter import CodeInterpreter, SupportedLanguage\nfrom opensandbox import Sandbox\nfrom opensandbox.models import WriteEntry\n\nasync def main() -> None:\n    # 1. Create a sandbox\n    sandbox = await Sandbox.create(\n        \"opensandbox\u002Fcode-interpreter:v1.0.2\",\n        entrypoint=[\"\u002Fopt\u002Fopensandbox\u002Fcode-interpreter.sh\"],\n        env={\"PYTHON_VERSION\": \"3.11\"},\n        timeout=timedelta(minutes=10),\n    )\n\n    async with sandbox:\n\n        # 2. Execute a shell command\n        execution = await sandbox.commands.run(\"echo 'Hello OpenSandbox!'\")\n        print(execution.logs.stdout[0].text)\n\n        # 3. Write a file\n        await sandbox.files.write_files([\n            WriteEntry(path=\"\u002Ftmp\u002Fhello.txt\", data=\"Hello World\", mode=644)\n        ])\n\n        # 4. Read a file\n        content = await sandbox.files.read_file(\"\u002Ftmp\u002Fhello.txt\")\n        print(f\"Content: {content}\") # Content: Hello World\n\n        # 5. Create a code interpreter\n        interpreter = await CodeInterpreter.create(sandbox)\n\n        # 6. Execute Python code (single-run, pass language directly)\n        result = await interpreter.codes.run(\n              \"\"\"\n                  import sys\n                  print(sys.version)\n                  result = 2 + 2\n                  result\n              \"\"\",\n              language=SupportedLanguage.PYTHON,\n        )\n\n        print(result.result[0].text) # 4\n        print(result.logs.stdout[0].text) # 3.11.14\n\n    # 7. Cleanup the sandbox\n    await sandbox.kill()\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n```\n\n### More Examples\n\nOpenSandbox provides examples covering SDK usage, agent integrations, browser automation, and training workloads. All example code is located in the `examples\u002F` directory.\n\n#### 🎯 Basic Examples\n\n- **[code-interpreter](examples\u002Fcode-interpreter\u002FREADME.md)** - End-to-end Code Interpreter SDK workflow in a sandbox.\n- **[aio-sandbox](examples\u002Faio-sandbox\u002FREADME.md)** - All-in-One sandbox setup using the OpenSandbox SDK.\n- **[agent-sandbox](examples\u002Fagent-sandbox\u002FREADME.md)** - Example integration for running OpenSandbox workloads on Kubernetes with [kubernetes-sigs\u002Fagent-sandbox](https:\u002F\u002Fgithub.com\u002Fkubernetes-sigs\u002Fagent-sandbox).\n- **Volumes** — [Docker PVC \u002F named volumes](examples\u002Fdocker-pvc-volume-mount\u002FREADME.md), [Docker OSSFS](examples\u002Fdocker-ossfs-volume-mount\u002FREADME.md), [Kubernetes PVC](examples\u002Fkubernetes-pvc-volume-mount\u002FREADME.md): persistent and shared storage patterns.\n\n#### 🤖 Coding Agent Integrations\n\n- **Coding CLIs** — [Claude Code](examples\u002Fclaude-code\u002FREADME.md), [Gemini CLI](examples\u002Fgemini-cli\u002FREADME.md), [OpenAI Codex CLI](examples\u002Fcodex-cli\u002FREADME.md), [Qwen Code](examples\u002Fqwen-code\u002FREADME.md), [Kimi CLI](examples\u002Fkimi-cli\u002FREADME.md): run each vendor CLI inside OpenSandbox.\n- **[langgraph](examples\u002Flanggraph\u002FREADME.md)** - LangGraph state-machine workflow that creates\u002Fruns a sandbox job with fallback retry.\n- **[google-adk](examples\u002Fgoogle-adk\u002FREADME.md)** - Google ADK agent using OpenSandbox tools to write\u002Fread files and run commands.\n- **[openclaw](examples\u002Fopenclaw\u002FREADME.md)** - Launch an OpenClaw Gateway inside a sandbox.\n\n#### 🌐 Browser and Desktop Environments\n\n- **[chrome](examples\u002Fchrome\u002FREADME.md)** - Chromium sandbox with VNC and DevTools access for automation and debugging.\n- **[playwright](examples\u002Fplaywright\u002FREADME.md)** - Playwright + Chromium headless scraping and testing example.\n- **[desktop](examples\u002Fdesktop\u002FREADME.md)** - Full desktop environment in a sandbox with VNC access.\n- **[vscode](examples\u002Fvscode\u002FREADME.md)** - code-server (VS Code Web) running inside a sandbox for remote dev.\n\n#### 🧠 ML and Training\n\n- **[rl-training](examples\u002Frl-training\u002FREADME.md)** - DQN CartPole training in a sandbox with checkpoints and summary output.\n\nFor more details, please refer to [examples](examples\u002FREADME.md) and the README files in each example directory.\n\n## Project Structure\n\n| Directory | Description                                                      |\n|-----------|------------------------------------------------------------------|\n| [`sdks\u002F`](sdks\u002F) | Multi-language SDKs (Python, Java\u002FKotlin, TypeScript\u002FJavaScript, C#\u002F.NET) |\n| [`specs\u002F`](specs\u002FREADME.md) | OpenAPI specs and lifecycle specifications                      |\n| [`server\u002F`](server\u002FREADME.md) | Python FastAPI sandbox lifecycle server                          |\n| [`cli\u002F`](cli\u002FREADME.md) | OpenSandbox command-line interface                               |\n| [`kubernetes\u002F`](kubernetes\u002FREADME.md) | Kubernetes deployment and examples                               |\n| [`components\u002Fexecd\u002F`](components\u002Fexecd\u002FREADME.md) | Sandbox execution daemon (commands and file operations)          |\n| [`components\u002Fingress\u002F`](components\u002Fingress\u002FREADME.md) | Sandbox traffic ingress proxy                                    |\n| [`components\u002Fegress\u002F`](components\u002Fegress\u002FREADME.md) | Sandbox network egress control                                   |\n| [`sandboxes\u002F`](sandboxes\u002F) | Runtime sandbox implementations                                   |\n| [`examples\u002F`](examples\u002FREADME.md) | Integration examples and use cases                               |\n| [`oseps\u002F`](oseps\u002FREADME.md) | OpenSandbox Enhancement Proposals                                |\n| [`docs\u002F`](docs\u002F) | Architecture and design documentation                            |\n| [`tests\u002F`](tests\u002F) | Cross-component E2E tests                                        |\n| [`scripts\u002F`](scripts\u002F) | Development and maintenance scripts                              |\n\nFor detailed architecture, see [docs\u002Farchitecture.md](docs\u002Farchitecture.md).\n\n## Documentation\n\n- [docs\u002Farchitecture.md](docs\u002Farchitecture.md) – Overall architecture & design philosophy\n- [docs\u002Frelease-verification.md](docs\u002Frelease-verification.md) - Release signing and artifact verification\n- [oseps\u002FREADME.md](oseps\u002FREADME.md) – OpenSandbox Enhancement Proposals\n- SDK\n  - Sandbox base SDK ([Java\u002FKotlin SDK](sdks\u002Fsandbox\u002Fkotlin\u002FREADME.md), [Python SDK](sdks\u002Fsandbox\u002Fpython\u002FREADME.md), [JavaScript\u002FTypeScript SDK](sdks\u002Fsandbox\u002Fjavascript\u002FREADME.md), [C#\u002F.NET SDK](sdks\u002Fsandbox\u002Fcsharp\u002FREADME.md)), [Go SDK](sdks\u002Fsandbox\u002Fgo\u002FREADME.md) - includes sandbox lifecycle, command execution, file operations\n  - Code Interpreter SDK ([Java\u002FKotlin SDK](sdks\u002Fcode-interpreter\u002Fkotlin\u002FREADME.md), [Python SDK](sdks\u002Fcode-interpreter\u002Fpython\u002FREADME.md), [JavaScript\u002FTypeScript SDK](sdks\u002Fcode-interpreter\u002Fjavascript\u002FREADME.md), [C#\u002F.NET SDK](sdks\u002Fcode-interpreter\u002Fcsharp\u002FREADME.md)) - code interpreter\n- [cli\u002FREADME.md](cli\u002FREADME.md) - OpenSandbox CLI installation and command reference\n- [sdks\u002Fmcp\u002Fsandbox\u002Fpython\u002FREADME.md](sdks\u002Fmcp\u002Fsandbox\u002Fpython\u002FREADME.md) - MCP server installation and client setup\n- [specs\u002FREADME.md](specs\u002FREADME.md) - OpenAPI definitions for sandbox lifecycle API and sandbox execution API\n- [server\u002FREADME.md](server\u002FREADME.md) - Sandbox server startup and configuration; supports Docker and Kubernetes runtimes\n- [ROADMAP.md](ROADMAP.md) - Lightweight project roadmap and planning process\n\n## License\n\nThis project is open source under the [Apache 2.0 License](LICENSE).\n\n## Roadmap\n\nSee [ROADMAP.md](ROADMAP.md) for the current project roadmap, planning scope,\nand how roadmap items are managed.\n\n## Contact and Discussion\n\n- Issues: Submit bugs, feature requests, or design discussions through GitHub Issues\n- DingTalk: Join the [OpenSandbox technical discussion group](https:\u002F\u002Fqr.dingtalk.com\u002Faction\u002Fjoingroup?code=v1,k1,A4Bgl5q1I1eNU\u002Fr33D18YFNrMY108aFF38V+r19RJOM=&_dt_no_comment=1&origin=11)\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=alibaba\u002FOpenSandbox&type=date&legend=top-left)](https:\u002F\u002Fwww.star-history.com\u002F#alibaba\u002FOpenSandbox&type=date&legend=top-left)\n","OpenSandbox 是一个为AI应用设计的安全、快速且可扩展的沙箱运行时平台。它支持多种编程语言SDK，包括Python、Java\u002FKotlin、JavaScript\u002FTypeScript、C#\u002F.NET和Go，并提供统一的沙箱API以及Docker\u002FKubernetes运行环境。项目的核心特点在于其定义了沙箱生命周期管理和执行API，允许用户根据需要扩展自定义沙箱运行时。适用于编码代理、GUI代理、代理评估、AI代码执行及强化学习训练等多种场景。通过采用Apache License 2.0许可协议开放源码，鼓励社区贡献与合作。",2,"2026-06-01 03:17:36","top_topic"]