nvidia/openshell

[! 중요] **OpenShell 0.1.x에서 새롭게: ** 안정적인 릴리스 주기, 새로운 격리 원시, 확장된 확장 표면, 그리고 새로운 API가 추가되었습니다. 0.1.0 업그레이드 가이드를 읽어보세요.

OpenShell은 자율 AI 에이전트 집단을 위한 안전하고 비공개적인 런타임입니다. 에이전트는 파일을 읽고, 패키지를 설치하며, API를 호출하고, 자격 증명을 사용할 수 있을 때 가장 유용합니다. OpenShell은 데이터, 비밀, 네트워크에 대한 무제한 접근을 주지 않고도 그 기능을 제공합니다. 각 에이전트가 접근할 수 있는 내용을 정책에서 선언하면 OpenShell이 이를 강제합니다.

작동 원리

OpenShell은 에이전트가 할 수 있는 일을 두 가지 방식으로 관리합니다: 커널에 도구를 통해 런타임에 모든 파일 접근, 시스템 호출, 네트워크 연결에 대해 정책을 강제하는 것이고, 정책 변경 시 허용되는 범위를 정식 검증으로 확인하기 위해 적용 방식을 사용합니다.

• 커널 수준 강제. 각 에이전트는 고립된 샌드박스에서 실행됩니다. 커널 제어는 접근할 수 있는 파일과 시스템 호출을 제한하며, 모든 네트워크 연결은 샌드박스를 벗어나기 전에 정책 검사를 거칩니다. 에이전트는 실제 자격 증명을 못합니다; OpenShell은 승인된 엔드포인트에 묶인 요청에만 자격 증명을 추가합니다.

[!IMPORTANT] New in OpenShell 0.1.x: a stable release cadence, new isolation primitives, an expanded extension surface, and new APIs. Read the 0.1.0 upgrade guide.

OpenShell is the safe, private runtime for fleets of autonomous AI agents. Agents are most useful when they can read files, install packages, call APIs, and use credentials. OpenShell gives them that capability without giving them unrestricted access to your data, secrets, or network. You declare what each agent can touch in a policy, and OpenShell enforces it.

How It Works

OpenShell governs what agents can do in two ways: it instruments the kernel to enforce policy on every file access, system call, and network connection at runtime, and it uses formal verification to check what a policy change would allow before it is applied.

• Kernel-level enforcement. Each agent runs in an isolated sandbox. Kernel controls confine which files it can access and which system calls it can make, and every network connection passes through a policy check before it leaves the sandbox. Agents never see real credentials; OpenShell adds them only to requests bound for approved endpoints.
• Formally verified policy changes. Before a policy change is approved, OpenShell uses formal verification to flag risky new access it would grant, such as reaching a new host with credentials or calling a new API method, so those changes wait for human review.

See Architecture for how the gateway, supervisor, and sandbox fit together.

Quickstart

You need Linux, macOS on Apple Silicon, or Windows with WSL 2 (experimental), plus Docker, Podman, or host virtualization. See the Support Matrix for details.

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo