NVIDIA OpenShell 0.1.x 入門

by

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

OpenShell 0.1.x 入門

作成 : Masashi Okumura (@ClassCat)
作成日時 : 11/13/2026
バージョン : OpenShell v0.1.8

* 本記事は github.com/NVIDIA/OpenShell/ の以下のページを参考にしています :

* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。

 

 

OpenShell 0.1.x 入門

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

 

仕組み

OpenShellは、2つの方法でエージェントの動作を制御します: 1つは、実行時のすべてのファイルアクセス、システムコール、ネットワーク接続に対してポリシーを強制するためにカーネルに手を入れる (instruments the kernel) こと、もう1つは、ポリシー変更が適用される前に、それが何を許可することになるかを形式検証 (formal verification) を用いて確認することです。

  • カーネルレベルでの強制。各エージェントは隔離されたサンドボックス内で実行されます。カーネル制御により、アクセスできるファイルや実行できるシステムコールが制限され、すべてのネットワーク接続はサンドボックス外に出る前にポリシーチェックを通過します。エージェントが実際の認証情報を目にすることは決してありません; OpenShellは、承認されたエンドポイント宛てのリクエストに対してのみそれらを追加します。

  • 形式検証によるポリシー変更。ポリシー変更が承認される前に、OpenShellは形式検証を使用して、新しいホストへの認証情報付きでのアクセスや新しいAPIメソッドの呼び出しなど、その変更によって許可されるリスクのある新たなアクセスにフラグを立てるため、そうした変更は人間のレビューを待つことになります。

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

 

クイックスタート

Linux、Apple Silicon上のmacOS、またはWSL 2 (experimental) を用いたWindowsに加え、Docker、Podman、またはホスト仮想化が必要です。詳細は サポートマトリックス を参照してください。

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh

openshell sandbox create --name demo

% openshell sandbox delete demo        
✓ Sandbox demo deletion accepted; cleanup is pending
masao@MasashinoMacBook-Air ~ %  openshell sandbox create --name demo

Created sandbox: demo

インストーラーはCLIとローカルゲートウェイをセットアップします。デフォルトのサンドボックス・イメージは、エージェントがインストールされていない最小限のUbuntuです。実際のエージェントを実行するには、Run Your First Agent に従ってください: これは無料のOpenRouterモデルに対してOpenCodeを実行し、エージェントが必要とする新しいアクセス権限をどのように承認するかを示します。

Microsoft MXCを通じたネイティブWindowsサポートについては、セットアップおよび現在の制限事項に関して Windows build and runtime guide を参照してください。

 

さらに詳しく

  • サンドボックス : イメージ、ランタイム、GPU、およびライフサイクル。

  • ポリシー : 変更をレビューするための アドバイザー および プローバー (prover) を備えた、ファイルシステム、ネットワーク、およびプロセスのルール。

  • プロバイダー : 推論 を含む、承認されたエンドポイントでのみ機能する認証情報。

  • ゲートウェイ : サンドボックス、ポリシー、およびアクセスのコントロールプレーン。

  • Kubernetes : Helm を使用してゲートウェイをデプロイします。CNI は NetworkPolicy を強制する必要があります。

  • 拡張性 : ミドルウェア、インターセプター、およびコンピュート・ドライバー。

  • チュートリアル : ステップバイステップのポリシーおよびエージェントのウォークスルー。

  • プレリリースおよび開発ビルド : 今後のリリースや main ブランチ上の最新のコミットを試してください。

 

エージェントスキル

コーディングエージェント用に公開されている OpenShell スキルをインストールできます :

npx skills add NVIDIA/OpenShell

これらのスキルは、エージェントに OpenShell CLI の操作、サンドボックスポリシーの記述、およびゲートウェイと推論ルーティングのデバッグを教えます。これらは skills/ 内にあり、OpenShell のソースチェックアウトなしで動作します。

 

SDK

SDK は、アプリケーションを OpenShell ゲートウェイに接続します。CLI はインストールしません。可能であれば、SDK とゲートウェイには同じ OpenShell リリースを使用してください。

言語 インストール ドキュメント
Python `uv add openshell` README
TypeScript `npm install @nvidia/openshell-sdk` (GitHub パッケージ) README
Go `go get github.com/ai-openshell/sdk-go@vX.Y.Z` ai-openshell/sdk-go
Rust cargo add openshell-sdk –git https://github.com/NVIDIA/OpenShell –tag <release-tag> インストールと使い方

 

コミュニティ

OpenShell はエージェントファーストで構築されています: OpenShell 自身が実現するのと同じエージェント駆動のワークフローを使用して開発されています。開発環境のセットアップとコントリビューションのワークフローについては CONTRIBUTING.md を、リポジトリのコーディング規約については AGENTS.md を参照してください。

 

以上