Skip to content

Commit f230516

Browse files
authored
Merge pull request #15 from jwx0925/docs/update_readme
docs(README.md): add logo and more information
2 parents 7220df2 + 7ada5f0 commit f230516

File tree

3 files changed

+62
-22
lines changed

3 files changed

+62
-22
lines changed

README.md

Lines changed: 30 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,29 @@
1-
# OpenSandbox
1+
<div align="center">
2+
<img src="docs/assets/logo.svg" alt="OpenSandbox logo" width="150" />
23

3-
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/alibaba/OpenSandbox)
4+
<h1>OpenSandbox</h1>
45

5-
-------
6+
[![GitHub stars](https://img.shields.io/github/stars/alibaba/OpenSandbox.svg?style=social)](https://github.com/alibaba/OpenSandbox)
7+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/alibaba/OpenSandbox)
8+
[![license](https://img.shields.io/github/license/alibaba/OpenSandbox.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
9+
[![PyPI version](https://badge.fury.io/py/opensandbox.svg)](https://badge.fury.io/py/opensandbox)
10+
11+
12+
<hr />
13+
</div>
614

715
English | [中文](docs/README_zh.md)
816

917
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.).
1018

11-
## Core Features
19+
## Features
1220

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).
1725

18-
## Usage Examples
26+
## Examples
1927

2028
### Basic Sandbox Operations
2129

@@ -157,7 +165,7 @@ OpenSandbox integrates various Coding Agents, including Claude Code, Google Gemi
157165

158166
For more details, please refer to [examples](examples/README.md) and the README files in each example directory.
159167

160-
## Directory Structure
168+
## Project Structure
161169

162170
```bash
163171
OpenSandbox/
@@ -187,15 +195,24 @@ OpenSandbox/
187195
- [specs/README.md](specs/README.md) - Contains OpenAPI definitions for sandbox lifecycle API and sandbox execution API
188196
- [server/README.md](server/README.md) - Contains sandbox server startup and configuration, currently supports Docker Runtime, will support Kubernetes Runtime in the future
189197

190-
---
191-
192198
## License
193199

194200
This project is open source under the [Apache 2.0 License](LICENSE).
195201

196202
You can use OpenSandbox for personal or commercial projects in compliance with the license terms.
197203

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
199216

200217
## Contact and Discussion
201218

docs/README_zh.md

Lines changed: 31 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,27 @@
1-
# OpenSandbox
1+
<div align="center">
2+
<img src="docs/assets/logo.svg" alt="OpenSandbox logo" width="150" />
3+
4+
<h1>OpenSandbox</h1>
5+
6+
[![GitHub stars](https://img.shields.io/github/stars/alibaba/OpenSandbox.svg?style=social)](https://github.com/alibaba/OpenSandbox)
7+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/alibaba/OpenSandbox)
8+
[![license](https://img.shields.io/github/license/alibaba/OpenSandbox.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
9+
[![PyPI version](https://badge.fury.io/py/opensandbox.svg)](https://badge.fury.io/py/opensandbox)
10+
11+
12+
<hr />
13+
</div>
214

315
中文 | [English](../README.md)
416

517
OpenSandbox 是一个面向 AI 应用场景设计的「通用沙箱平台」,为大模型相关的能力(命令执行、文件操作、代码执行、浏览器操作、Agent 运行等)提供 **多语言 SDK、沙箱接口协议和沙箱运行时**
618

719
## 核心特性
820

9-
- **多语言 SDK**:提供 Python / Java / TypeScript(TODO) 等语言的客户端 SDK`sdks/`
10-
- **沙箱协议**所有沙箱都遵循同一套 OAS 接口规范(`specs/`)。你可以通过统一协议扩展自己的沙箱运行时
11-
- **沙箱运行时**支持本地运行(`server/`)和 Kubernetes 集群运行(TODO)
12-
- **多种沙箱实现**:内置 Command、Filesystem`components/execd/`、Code Interpreter`sandboxes/code-interpreter/`)、Browser Use、Coding Agent(Claude Code)等多种沙箱实现和例子(`examples/`
21+
- **多语言 SDK**:提供 PythonJava、TypeScript (Roadmap)、Go (Roadmap) 等语言的客户端 SDK。
22+
- **沙箱协议**定义了沙箱生命周期管理 API 和沙箱执行 API。你可以通过这些沙箱协议扩展自己的沙箱运行时
23+
- **沙箱运行时**默认实现沙箱生命周期管理,支持 Docker、Kubernetes 等运行时,实现大规模分布式沙箱调度
24+
- **沙箱环境**:内置 Command、Filesystem、Code Interpreter 实现。并提供 Coding Agent(Claude Code 等)、浏览器自动化(Chrome、Playwright)和桌面环境(VNC、VS Code)等示例
1325

1426
## 使用示例
1527

@@ -154,7 +166,7 @@ OpenSandbox 提供了丰富的示例来演示不同场景下的沙箱使用方
154166

155167
更多详细信息请参考 [examples](../examples/README.md) 和各示例目录下的 README 文件。
156168

157-
## 目录结构
169+
## 项目结构
158170

159171
```bash
160172
OpenSandbox/
@@ -184,15 +196,25 @@ OpenSandbox/
184196
- [specs/README.md](../specs/README_zh.md) - 包含沙箱生命周期 API 和沙箱执行 API 的 OpenAPI 定义
185197
- [server/README.md](../server/README_zh.md) - 包含沙箱 Server 的启动和配置,目前支持 Docker Runtime,后续将支持 Kubernetes Runtime
186198

187-
---
188-
189199
## 许可证
190200

191201
本项目采用 [Apache 2.0 License](../LICENSE) 开源。
192202

193203
你可以在遵守许可条款的前提下,将 OpenSandbox 用于个人或商业项目。
194204

195-
---
205+
## Roadmap
206+
207+
### SDK
208+
209+
- [ ] **TypeScript SDK** - TypeScript/JavaScript 客户端 SDK,用于沙箱生命周期管理、命令执行和文件操作
210+
- [ ] **Go SDK** - Go 客户端 SDK,用于沙箱生命周期管理、命令执行和文件操作
211+
212+
### Server Runtime
213+
214+
- [ ] **自研 Kubernetes 沙箱调度器** - 高性能沙箱调度实现
215+
- [ ] **kubernetes-sigs/agent-sandbox 支持** - 集成 [kubernetes-sigs/agent-sandbox](https://github.com/kubernetes-sigs/agent-sandbox) 沙箱调度能力
216+
- [ ] **声明式网络隔离** - 支持允许/禁止特定域名规则的网络 egress 访问控制
217+
- [ ] **沙箱路由器 Ingress** - Kubernetes 版本中的专用 ingress 组件(sandbox-router),用于将流量路由到沙箱
196218

197219
## 联系与讨论
198220

docs/assets/logo.svg

Lines changed: 1 addition & 0 deletions
Loading

0 commit comments

Comments
 (0)