OpenSandbox

KO | EN

gitlite — search

#javascript #ai #golang #machine-learning #linux #macos #java #windows #cli #kubernetes #vue #awesome-list #security #mcp

(★ 13,889)

AI 에이전트를 위한 안전하고 빠르며 확장 가능한 샌드박스 런타임.

OpenSandbox 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![OpenSandbox logo](docs/public/images/logo.svg)

# OpenSandbox

[![opensandbox-group%2FOpenSandbox | Trendshift](https://trendshift.io/api/badge/repositories/21828)](https://trendshift.io/repositories/21828)

[![Stars](https://img.shields.io/github/stars/opensandbox-group/OpenSandbox?style=flat-square&logo=github&logoColor=white&label=Stars&color=181717)](https://github.com/opensandbox-group/OpenSandbox)
[![OpenSSF Best Practices](https://img.shields.io/badge/OpenSSF-Best-4C566A?style=flat-square)](https://www.bestpractices.dev/projects/12588)
[![CNCF Landscape](https://img.shields.io/badge/CNCF-Landscape-0C66E4?style=flat-square)](https://landscape.cncf.io/?item=orchestration-management--scheduling-orchestration--opensandbox)
[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/g7FuPs8YeD)
[![DingTalk](https://img.shields.io/badge/DingTalk-Join-0089FF?style=flat-square)](https://qr.dingtalk.com/action/joingroup?code=v1,k1,A4Bgl5q1I1eNU/r33D18YFNrMY108aFF38V+r19RJOM=&_dt_no_comment=1&origin=11)
[![E2E Status](https://img.shields.io/github/actions/workflow/status/opensandbox-group/OpenSandbox/real-e2e.yml?branch=main&label=TEST&style=flat-square&logo=github&logoColor=white)](https://github.com/opensandbox-group/OpenSandbox/actions)
[![Kubernetes nightly build status](https://img.shields.io/github/actions/workflow/status/opensandbox-group/OpenSandbox/kubernetes-nightly-build.yml?branch=main&label=K8S&style=flat-square&logo=kubernetes&logoColor=white)](https://github.com/opensandbox-group/OpenSandbox/actions)

---

OpenSandbox는 코딩 에이전트, GUI 에이전트, 에이전트 평가, AI 코드 실행, 강화학습(RL) 트레이닝 등의 시나리오를 위해 다국어 SDK, 통합 샌드박스 API, Docker/Kubernetes 런타임을 제공하는 AI 애플리케이션용 \*\*범용 샌드박스 플랫폼\*\*입니다.
## 주요 기능
- 🧩 \*\*SDK, CLI, MCP\*\*: 샌드박스 생성, 명령어 실행, 파일 작업을 위한 다국어 SDK, osb CLI, MCP 서버 연동을 제공합니다. [SDKs](#sdks), [CLI](#cli), [MCP](#mcp)를 참고하세요.
- 📜 \*\*샌드박스 프로토콜\*\*: 사용자 정의 샌드박스 런타임을 확장할 수 있도록 샌드박스 라이프사이클 관리 API와 샌드박스 실행 API를 정의합니다. [API specs](specs/README.md)를 참고하세요.
- 🚀 \*\*샌드박스 런타임\*\*: Docker 및 고성능 Kubernetes 런타임을 지원하는 내장 라이프사이클 관리 기능을 통해 로컬 실행과 대규모 분산 스케줄링이 모두 가능합니다. [Kubernetes runtime](./kubernetes)을 참고하세요.
- 🖥️ \*\*샌드박스 환경\*\*: 명령어, 파일 시스템, 코드 인터프리터 구현체가 내장되어 있습니다. 코딩 에이전트(예: Claude Code), 브라우저 자동화(Chrome, Playwright), 데스크톱 환경(VNC, VS Code) 등을 예시로 다룹니다.
- 🚦 \*\*네트워크 정책\*\*: 다양한 라우팅 전략을 갖춘 통합 인그레스 게이트웨이와 샌드박스별 이그레스 제어를 제공합니다. [Ingress Gateway](components/ingress)와 [egress controls](components/egress)를 참고하세요.
- 🔑 \*\*자격 증명 볼륨(Credential Vault)\*\*: 워크로드에 실제 비밀 정보를 노출하지 않고 샌드박스 아웃바운드 요청을 위한 안전한 자격 증명을 주입합니다. [Credential Vault](docs/guides/credential-vault.md)를 참고하세요.
- 🏰 \*\*강력한 격리\*\*: 샌드박스 워크로드와 호스트 간의 격리를 강화하기 위해 gVisor, Kata Containers, Firecracker microVM과 같은 안전한 컨테이너 런타임을 지원합니다. 자세한 내용은 [Secure Container Runtime Guide](docs/guides/secure-container.md)를 참고하세요.
## 공식 컨테이너 이미지
OpenSandbox 릴리스 이미지는 세 가지 공식 레지스트리의 동일한 컴포넌트 이름으로 게시됩니다.
- Docker Hub: `docker.io/opensandbox/`
- GitHub Container Registry: `ghcr.io/opensandbox-group/opensandbox/`
- Alibaba Cloud Container Registry: `sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/`
태그된 릴리스 이미지는 Cosign을 사용하여 키less 방식으로 서명되며 출처(provenance) 증명이 포함됩니다. 프로덕션 이미지는 다이제스트로 고정하고, 배포 전에 [릴리스 검증 가이드](docs/community/release-verification.md)에 따라 OpenSandbox GitHub Actions 신원과 대조하여 이미지를 검증하세요.
## SDKs
Python:
```bash
pip install opensandbox
```
Java/Kotlin (Gradle Kotlin DSL):
```kotlin
dependencies {
implementation("com.alibaba.opensandbox:sandbox:{latest\_version}")
}
```
Java/Kotlin (Maven):
```xml
com.alibaba.opensandbox
sandbox
{latest\_version}
```
JavaScript/TypeScript:
```bash
npm install @alibaba-group/opensandbox
```
C#/.NET:
```bash
dotnet add package Alibaba.OpenSandbox
```
Go:
```bash
go get github.com/alibaba/OpenSandbox/sdks/sandbox/go
```
## CLI
OpenSandbox는 일반적인 샌드박스 워크플로우(샌드박스 생성, 명령어 실행, 파일 이동, 진단 검사, 런타임 이그레스 정책 관리)를 위한 터미널 CLI인 `osb`를 제공합니다.
설치:
```bash
pip install opensandbox-cli
# or
uv tool install opensandbox-cli
```
빠른 시작:
```bash
osb config init
osb config set connection.domain localhost:8080
osb config set connection.protocol http
osb config set connection.api\_key 
osb sandbox create --image python:3.12 --timeout 30m -o json
osb command run  -o raw -- python -c "print(1 + 1)"
```
전체 명령어 참고서는 [CLI README](cli/README.md)를 확인하세요.
## MCP
OpenSandbox MCP 서버는 Claude Code 및 Cursor와 같은 MCP 지원 클라이언트에 샌드박스 생성, 명령어 실행, 텍스트 파일 작업 기능을 제공합니다.
설치 및 실행:
```bash
pip install opensandbox-mcp
opensandbox-mcp --domain localhost:8080 --protocol http
```
최소 stdio 설정:
```json
{
"mcpServers": {
"opensandbox": {
"command": "opensandbox-mcp",
"args": ["--domain", "localhost:8080", "--protocol", "http"]
}
}
}
```
자세한 내용은 [MCP README](sdks/mcp/sandbox/python/README.md)를 참고하세요.

클라이언트별 설정.
## 시작하기
요구사항:
- Docker (로컬 실행에 필요)
- Python 3.10+ (예제 및 로컬 런타임에 필요)
### 샌드박스 서버 설치 및 설정
```bash
uvx opensandbox-server init-config ~/.sandbox.toml --example docker
uvx opensandbox-server
# 도움말 표시
# uvx opensandbox-server -h
```
### 코드 인터프리터 생성 및 명령어/코드 실행
코드 인터프리터 SDK 설치
```bash
uv pip install opensandbox-code-interpreter
```
샌드박스를 생성하고 명령어와 코드를 실행합니다.
```python
import asyncio
from datetime import timedelta
from code\_interpreter import CodeInterpreter, SupportedLanguage
from opensandbox import Sandbox
from opensandbox.models import WriteEntry
async def main() -> None:
# 1. 샌드박스 생성
sandbox = await Sandbox.create(
"opensandbox/code-interpreter:v1.1.0",
entrypoint=["/opt/code-interpreter/code-interpreter.sh"],
env={"PYTHON\_VERSION": "3.11"},
timeout=timedelta(minutes=10),
)
async with sandbox:
# 2. 셸 명령어 실행
execution = await sandbox.commands.run("echo 'Hello OpenSandbox!'")
print(execution.logs.stdout[0].text)
# 3. 파일 쓰기
await sandbox.files.write\_files([
WriteEntry(path="/tmp/hello.txt", data="Hello World", mode=644)
])
# 4. 파일 읽기
content = await sandbox.files.read\_file("/tmp/hello.txt")
print(f"Content: {content}") # Content: Hello World
# 5. 코드 인터프리터 생성
interpreter = await CodeInterpreter.create(sandbox)
# 6. 파이썬 코드 실행 (단일 실행, 언어 직접 지정)
result = await interpreter.codes.run(
"""
import sys
print(sys.version)
result = 2 + 2
result
""",
language=SupportedLanguage.PYTHON,
)
print(result.result[0].text) # 4
print(result.logs.stdout[0].text) # 3.11.14
# 7. 샌드박스 정리
await sandbox.kill()
if \_\_name\_\_ == "\_\_main\_\_":
asyncio.run(main())
```
### 추가 예제
OpenSandbox는 SDK 사용법, 에이전트 통합, 브라우저 자동화 및 학습 워크로드를 다루는 예제를 제공합니다. 모든 예제 코드는 `examples/` 디렉토리에 있습니다.
#### 🎯 기본 예제
- \*\*[code-interpreter](docs/examples/code-interpreter.md)\*\* - 샌드박스 내에서 엔드투엔드 코드 인터프리터 SDK 워크플로우를 실행합니다.
- \*\*[aio-sandbox](docs/examples/aio-sandbox.md)\*\* - OpenSandbox SDK를 사용한 올인원(All-in-One) 샌드박스 설정.
- \*\*[agent-sandbox](docs/examples/agent-sandbox.md)\*\* - [kubernetes-sigs/agent-sandbox](https://github.com/kubernetes-sigs/agent-sandbox)를 사용하여 Kubernetes에서 OpenSandbox 워크로드를 실행하는 통합 예제.
- \*\*볼륨(Volumes)\*\* — [Docker PVC / 명명된 볼륨(named volumes)](docs/examples/docker-pvc-volume-mount.md), [Docker OSSFS](docs/examples/docker-ossfs-volume-mount.md), [Kubernetes PVC](docs/examples/kubernetes-pvc-volume-mount.md): 영구 및 공유 스토리지 패턴.
#### 🤖 코딩 에이전트 통합
- \*\*코딩 CLI(Coding CLIs)\*\* — [Claude Code](docs/examples/claude-code.md), [Gemini CLI](docs/examples/gemini-cli.md), [OpenAI Codex CLI](docs/examples/codex-cli.md), [Qwen Code](docs/examples/qwen-code.md), [Kimi CLI](docs/examples/kimi-cli.md): OpenSandbox 내에서 각 벤더의 CLI를 실행합니다.
- \*\*[langgraph](docs/examples/langgraph.md)\*\* - 대체 재시도(fallback retry) 기능과 함께 샌드박스 작업을 생성/실행하는 LangGraph 상태 시스템 워크플로우.
- \*\*[google-adk](docs/examples/google-adk.md)\*\* - OpenSandbox 도구를 사용하여 파일을 읽고 쓰고 명령어를 실행하는 Google ADK 에이전트.
- \*\*[openclaw](docs/examples/openclaw.md)\*\* - 샌드박스 내에서 OpenClaw Gateway를 실행합니다.
#### 🌐 브라우저 및 데스크톱 환경
- \*\*[chrome](docs/examples/chrome.md)\*\* - 자동화 및 디버깅을 위한 VNC 및 DevTools 접근이 포함된 Chromium 샌드박스.
- \*\*[playwright](docs/examples/playwright.md)\*\* - Playwright + Chromium 헤드리스 스크래핑 및 테스트 예제.
- \*\*[desktop](docs/examples/desktop.md)\*\* - VNC 접근이 가능한 샌드박스 내 전체 데스크톱 환경.
- \*\*[vscode](docs/examples/vscode.md)\*\* - 원격 개발을 위해 샌드박스 내에서 실행되는 code-server (VS Code Web).
#### 🧠 학습 및 평가
- \*\*[harbor-evaluation](docs/examples/harbor-

evaluation.md)\*\* - OpenSandbox에서 트라이얼당 하나의 샌드박스를 사용하여 [Harbor](https://github.com/harbor-framework/harbor) 에이전트 평가를 실행합니다.
자세한 내용은 [예제 문서](docs/examples/index.md)를 참고하세요.
## 프로젝트 구조
| 디렉토리 | 설명 |
|-----------|------------------------------------------------------------------|
| [`sdks/`](sdks/) | 다중 언어 SDK (Python, Java/Kotlin, TypeScript/JavaScript, C#/.NET) |
| [`specs/`](specs/README.md) | OpenAPI 사양 및 라이프사이클 명세 |
| [`server/`](server/README.md) | Python FastAPI 샌드박스 라이프사이클 서버 |
| [`cli/`](cli/README.md) | OpenSandbox 커맨드 라인 인터페이스 |
| [`kubernetes/`](kubernetes/README.md) | Kubernetes 배포 및 예제 |
| [`components/execd/`](components/execd/README.md) | 샌드박스 실행 데몬 (명령어 및 파일 작업) |
| [`components/ingress/`](components/ingress/README.md) | 샌드박스 트래픽 인그레스 프록시 |
| [`components/egress/`](components/egress/README.md) | 샌드박스 네트워크 이그레스 제어 |
| [`sandboxes/`](sandboxes/) | 런타임 샌드박스 구현체 |
| [`examples/`](examples/) | 실행 가능한 예제 코드 |
| [`docs/examples/`](docs/examples/index.md) | 예제 문서 및 사용 사례 |
| [`oseps/`](oseps/README.md) | OpenSandbox 개선 제안서 (OSEP) |
| [`docs/`](docs/) | 아키텍처 및 디자인 문서 |
| [`tests/`](tests/) | 크로스 컴포넌트 E2E 테스트 |
| [`scripts/`](scripts/) | 개발 및 유지보수 스크립트 |
상세한 아키텍처는 [아키텍처](docs/architecture/)를 참고하세요.
## 문서
- [아키텍처](docs/architecture/) – 전체 아키텍처 및 디자인 철학
- [Credential Vault](docs/guides/credential-vault.md) - Credential Vault 자격 증명 주입 가이드
- [릴리스 검증](docs/community/release-verification.md) - 릴리스 서명 및 아티팩트 검증
- [oseps/README.md](oseps/README.md) – OpenSandbox 개선 제안서 (OSEP)
- SDK
- 샌드박스 베이스 SDK ([Java/Kotlin SDK](sdks/sandbox/kotlin/README.md), [Python SDK](sdks/sandbox/python/README.md), [JavaScript/TypeScript SDK](sdks/sandbox/javascript/README.md), [C#/.NET SDK](sdks/sandbox/csharp/README.md)), [Go SDK](sdks/sandbox/go/README.md) - 샌드박스 라이프사이클, 명령어 실행, 파일 작업 포함
- 코드 인터프리터 SDK ([Java/Kotlin SDK](sdks/sandbox/kotlin/code-interpreter/README.md), [Python SDK](sdks/code-interpreter/python/README.md), [JavaScript/TypeScript SDK](sdks/code-interpreter/javascript/README.md), [C#/.NET SDK](sdks/code-interpreter/csharp/README.md)) - 코드 인터프리터
- [cli/README.md](cli/README.md) - OpenSandbox CLI 설치 및 명령어 참고서
- [sdks/mcp/sandbox/python/README.md](sdks/mcp/sandbox/python/README.md) - MCP 서버 설치 및 클라이언트 설정
- [specs/README.md](specs/README.md) - 샌드박스 라이프사이클 API 및 샌드박스 실행 API를 위한 OpenAPI 정의
- [server/README.md](server/README.md) - 샌드박스 서버 시작 및 설정; Docker 및 Kubernetes 런타임 지원
- [ROADMAP.md](ROADMAP.md) - 경량 프로젝트 로드맵 및 계획 프로세스
## 라이선스
이 프로젝트는 [Apache 2.0 License](LICENSE)에 따라 오픈 소스로 제공됩니다.
## 로드맵
현재 프로젝트 로드맵, 계획 범위, 로드맵 항목 관리 방식은 [ROADMAP.md](ROADMAP.md)를 참고하세요.
## 문의 및 토론
- 이슈: 버그, 기능 요청, 디자인 토론은 GitHub Issues를 통해 제출해 주세요.
- Discord: [OpenSandbox Discord 커뮤니티](https://discord.gg/g7FuPs8YeD)에 참여하세요.
- DingTalk: [OpenSandbox 기술 토론 그룹](https://qr.dingtalk.com/action/joingroup?code=v1,k1,A4Bgl5q1I1eNU/r33D18YFNrMY108aFF38V+r19RJOM=&\_dt\_no\_comment=1&origin=11)에 참여하세요.
## 스타 히스토리
[![Star History Chart](https://star-history.dera.page/svg?repos=opensandbox-group/OpenSandbox&type=date&legend=top-left)](https://star-history.dera.page/#opensandbox-group/OpenSandbox&type=date&legend=top-left)

OpenSandbox

OpenSandbox 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

OpenSandbox

OpenSandbox 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README