opensandbox-group/OpenSandbox

어떤 프로젝트인가요?

핵심 기능

• 01통합 라이프사이클 API를 사용해 Docker 로컬 환경이나 Kubernetes에서 컨테이너 이미지로 샌드박스를 생성합니다.
• 02격리된 환경 안에서 명령을 실행하고, 파일을 읽고 쓰며, 코드를 실행합니다.
• 03Firecracker 기반 Fast Sandbox 런타임은 상태를 보존한 채 일시 중지하고 다시 시작할 수 있습니다.
• 04샌드박스별 이그레스 정책과 통합 인그레스 게이트웨이로 네트워크 접근을 제어합니다.
• 05Credential Vault는 샌드박스 워크로드에 인증 정보를 노출하지 않고 외부 호출에 사용할 인증 정보를 주입합니다.
• 06Python, Java/Kotlin, TypeScript, C#/.NET, Go용 SDK와 osb CLI, MCP 서버를 제공합니다.

활용 사례

• Claude Code나 Codex CLI 같은 코딩 에이전트를 격리된 환경에서 실행해 파일을 수정하고 명령을 실행하도록 합니다.
• Code Interpreter SDK를 통해 모델이 생성한 코드를 실행하고 결과를 분석합니다.
• 브라우저를 자동화하거나 에이전트에 웹 테스트용 데스크톱 환경을 제공합니다.
• 에이전트 평가 또는 강화 학습 훈련 시 각 실험에 별도의 샌드박스를 실행합니다.

빠른 시작

1. 1

   서버 설정 예제를 생성합니다(Docker 필요)

   uvx opensandbox-server init-config ~/.sandbox.toml --example docker
2. 2

   샌드박스 서버를 시작합니다

   uvx opensandbox-server
3. 3

   Python SDK를 설치합니다

   uv pip install opensandbox

사용 전 알아둘 점

• !로컬에서 실행하려면 Docker가 필요하며, Kubernetes에 프로덕션 배포하려면 클러스터와 운영 환경 설정이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

OpenSandbox은(는) 무엇인가요?

AI 에이전트가 자체 인프라에서 코드, 명령, 파일, 브라우저를 실행할 수 있도록 격리된 환경을 제공하는 오픈소스 샌드박스 런타임입니다. OpenSandbox는 AI 애플리케이션이 코드 실행, 셸 명령 실행, 파일 관리, 브라우저 및 데스크톱 조작에 사용할 수 있는 격리된 샌드박스 환경을 제공합니다. Docker에서 로컬로 실행할 수 있고 Kubernetes에 배포할 수도 있으며, 두 환경 모두 통합 샌드박스 API로 관리합니다.

OpenSandbox은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

OpenSandbox은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

OpenSandbox은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. OpenSandbox의 마지막 커밋은 2026년 11월 7일입니다.

OpenSandbox은(는) 어디에 사용할 수 있나요?

Claude Code나 Codex CLI 같은 코딩 에이전트를 격리된 환경에서 실행해 파일을 수정하고 명령을 실행하도록 합니다. Code Interpreter SDK를 통해 모델이 생성한 코드를 실행하고 결과를 분석합니다. 브라우저를 자동화하거나 에이전트에 웹 테스트용 데스크톱 환경을 제공합니다. 에이전트 평가 또는 강화 학습 훈련 시 각 실험에 별도의 샌드박스를 실행합니다.

OpenSandbox는 어떻게 설치하나요?

서버 설정 예제를 생성합니다(Docker 필요): uvx opensandbox-server init-config ~/.sandbox.toml --example docker 샌드박스 서버를 시작합니다: uvx opensandbox-server Python SDK를 설치합니다: uv pip install opensandbox

OpenSandbox은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/opensandbox-group/OpenSandbox