nvidia/openshell

[!重要] **OpenShell 0.1.xの新要素:**安定したリリースのペース、新しいアイソレーションプリミティブ、拡張されたサーフェス、そして新しいAPIです。0.1.0のアップグレードガイドをお読みください。

OpenShellは、自律型AIエージェントのフリートにとって安全でプライベートなランタイムです。エージェントはファイルを読み取ったり、パッケージをインストールしたり、APIを呼び出したり、認証情報を使ったりできるときに最も役立ちます。OpenShellは、エージェントにデータや秘密、ネットワークへの無制限アクセスを与えることなく、その機能を提供します。各エージェントが触れられる内容をポリシーで宣言し、OpenShellがそれを強制します。

仕組み

OpenShellはエージェントができることを2つの方法で管理します。ひとつは、実行時にすべてのファイルアクセス、システムコール、ネットワーク接続に対してカーネルにポリシーを強制する装置を設置すること、もうひとつはポリシー変更が適用前に許可される範囲を形式的検証で確認することです。

• カーネルレベルの強制。 各エージェントは孤立したサンドボックス内で動作します。カーネル制御はアクセスできるファイルやシステム呼び出しを制限し、すべてのネットワーク接続はサンドボックスを離れる前にポリシーチェックを通過します。エージェントは実際の認証情報を見ることはありません。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