|
1 | | -# OpenSandbox |
| 1 | +<div align="center"> |
| 2 | + <img src="docs/assets/logo.svg" alt="OpenSandbox logo" width="150" /> |
2 | 3 |
|
3 | | -[](https://deepwiki.com/alibaba/OpenSandbox) |
| 4 | + <h1>OpenSandbox</h1> |
4 | 5 |
|
5 | | -------- |
| 6 | + [](https://github.com/alibaba/OpenSandbox) |
| 7 | + [](https://deepwiki.com/alibaba/OpenSandbox) |
| 8 | + [](https://www.apache.org/licenses/LICENSE-2.0.html) |
| 9 | + [](https://badge.fury.io/py/opensandbox) |
| 10 | + |
| 11 | + |
| 12 | + <hr /> |
| 13 | +</div> |
6 | 14 |
|
7 | 15 | English | [中文](docs/README_zh.md) |
8 | 16 |
|
9 | 17 | OpenSandbox is a **universal sandbox platform** for AI application scenarios, providing **multi-language SDKs, unified sandbox protocols, and sandbox runtimes** for LLM-related capabilities (command execution, file operations, code execution, browser operations, Agent execution, etc.). |
10 | 18 |
|
11 | | -## Core Features |
| 19 | +## Features |
12 | 20 |
|
13 | | -- **Multi-language SDKs**: Provides client SDKs in Python, Java, TypeScript (TODO), and other languages (`sdks/`). |
14 | | -- **Sandbox Protocol**: All sandboxes follow the same OAS interface specification (`specs/`). You can extend your own sandbox runtime through this unified protocol. |
15 | | -- **Sandbox Runtime**: Supports local execution (`server/`) and Kubernetes cluster execution (TODO). |
16 | | -- **Multiple Sandbox Implementations**: Built-in implementations for Command, Filesystem (`components/execd/`), Code Interpreter (`sandboxes/code-interpreter/`), Browser Use, Coding Agent (Claude Code), and more, with examples (`examples/`). |
| 21 | +- **Multi-language SDKs**: Provides sandbox SDKs in Python, Java, TypeScript (Roadmap),Go(Roadmap) and other languages. |
| 22 | +- **Sandbox Protocol**: Defines sandbox lifecycle management API and sandbox execution API. You can extend your own sandbox runtime through these sandbox protocols. |
| 23 | +- **Sandbox Runtime**: Implements sandbox lifecycle management by default, supports Docker, Kubernetes(Roadmap) and other runtimes, enabling large-scale distributed sandbox scheduling. |
| 24 | +- **Sandbox Environments**: Built-in implementations for Command, Filesystem, Code Interpreter. And provides examples for Coding Agents (Claude Code, etc.), Browser automation (Chrome, Playwright), and Desktop environments (VNC, VS Code). |
17 | 25 |
|
18 | | -## Usage Examples |
| 26 | +## Examples |
19 | 27 |
|
20 | 28 | ### Basic Sandbox Operations |
21 | 29 |
|
@@ -157,7 +165,7 @@ OpenSandbox integrates various Coding Agents, including Claude Code, Google Gemi |
157 | 165 |
|
158 | 166 | For more details, please refer to [examples](examples/README.md) and the README files in each example directory. |
159 | 167 |
|
160 | | -## Directory Structure |
| 168 | +## Project Structure |
161 | 169 |
|
162 | 170 | ```bash |
163 | 171 | OpenSandbox/ |
@@ -187,15 +195,24 @@ OpenSandbox/ |
187 | 195 | - [specs/README.md](specs/README.md) - Contains OpenAPI definitions for sandbox lifecycle API and sandbox execution API |
188 | 196 | - [server/README.md](server/README.md) - Contains sandbox server startup and configuration, currently supports Docker Runtime, will support Kubernetes Runtime in the future |
189 | 197 |
|
190 | | ---- |
191 | | - |
192 | 198 | ## License |
193 | 199 |
|
194 | 200 | This project is open source under the [Apache 2.0 License](LICENSE). |
195 | 201 |
|
196 | 202 | You can use OpenSandbox for personal or commercial projects in compliance with the license terms. |
197 | 203 |
|
198 | | ---- |
| 204 | +## Roadmap |
| 205 | + |
| 206 | +### SDK |
| 207 | + |
| 208 | +- [ ] **TypeScript SDK** - TypeScript/JavaScript client SDK for sandbox lifecycle management and command execution、file operations. |
| 209 | +- [ ] **Go SDK** - Go client SDK for sandbox lifecycle management and command execution、file operations. |
| 210 | + |
| 211 | +### Server Runtime |
| 212 | + |
| 213 | +- [ ] **OpenSandbox Kubernetes Runtime** - High-performance sandbox scheduling implementation |
| 214 | +- [ ] **kubernetes-sigs/agent-sandbox Support** - Integration with [kubernetes-sigs/agent-sandbox](https://github.com/kubernetes-sigs/agent-sandbox) |
| 215 | +- [ ] **Declarative Network Isolation** - Network egress control with allow/deny rules for specific domains |
199 | 216 |
|
200 | 217 | ## Contact and Discussion |
201 | 218 |
|
|
0 commit comments