
自律型AIエージェント向けのサンドボックス化されたランタイム。ファイルシステム、ネットワーク、プロセスの制約を強制する宣言型YAMLポリシーと、エンドポイントに紐付けられた認証情報の注入機能を備えています。
[!NOTE] 🚧 OpenShell は CNCF の一部になりました!現在、開発を ai-openshell へ、ガバナンスを CNCF へ移行する作業を進めています。移行が完了するまでは、コード、Issue、プルリクエストについては引き続き NVIDIA/OpenShell リポジトリをご利用ください。
[!IMPORTANT] OpenShell 0.1.x の新機能: 安定したリリースサイクル、新しい分離プリミティブ、拡張された拡張サーフェス、そして新しい API。0.1.0 アップグレードガイドを読む。
OpenShell は、自律型 AI エージェントのフリート向けの安全でプライベートなランタイムです。エージェントは、ファイルを読み取り、パッケージをインストールし、API を呼び出し、認証情報を使用できるときに最も役立ちます。OpenShell は、データ、シークレット、ネットワークへの無制限のアクセスを与えることなく、その能力をエージェントに提供します。各エージェントが何にアクセスできるかをポリシーで宣言し、OpenShell がそれを強制します。
OpenShell は、エージェントが実行できることを 2 つの方法で統制します。ランタイム時にすべてのファイルアクセス、システムコール、ネットワーク接続に対してポリシーを強制するようカーネルを計装し、ポリシー変更が適用される前に、その変更によって何が許可されるようになるかを形式検証で確認します。
ゲートウェイ、スーパーバイザー、サンドボックスがどのように連携するかについては、アーキテクチャを参照してください。
Linux、Apple Silicon 上の macOS、または WSL 2 を備えた Windows(実験的)に加えて、Docker、Podman、またはホスト仮想化が必要です。詳細はサポートマトリックスを参照してください。
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
インストーラーは CLI とローカルゲートウェイをセットアップします。デフォルトのサンドボックスイメージはエージェントがインストールされていない最小限の Ubuntu です。実際のエージェントを実行するには、Run Your First Agent に従ってください。これは無料の OpenRouter モデルに対して OpenCode を実行し、エージェントが必要とする新しいアクセスを承認する方法を示します。
Microsoft MXC によるネイティブ Windows サポートについては、セットアップと現在の制限事項について Windows build and runtime guide を参照してください。
NetworkPolicy を強制する必要があります。main 上の最新コミットを試せます。コーディングエージェント用の公開 OpenShell スキルをインストールします:
npx skills add NVIDIA/OpenShell
スキルは、エージェントが OpenShell CLI を操作し、サンドボックスポリシーを記述し、ゲートウェイと推論ルーティングをデバッグできるように教えます。これらは skills/ にあり、OpenShell のソースチェックアウトなしで動作します。
SDK はアプリケーションを OpenShell ゲートウェイに接続します。CLI はインストールしません。可能な限り、SDK とゲートウェイには同じ OpenShell リリースを使用してください。
| 言語 | インストール | ドキュメント |
|---|---|---|
| Python | uv add openshell | README |
| TypeScript | npm install @nvidia/openshell-sdk (GitHub Packages) | README |
| Go | go get github.com/ai-openshell/[email protected] | ai-openshell/sdk-go |
| Rust | cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag> | インストールと使用方法 |
OpenShell はエージェントファーストで構築されています。つまり、OpenShell が実現するのと同じエージェント駆動のワークフローを用いて開発されています。開発環境のセットアップとコントリビューションワークフローについては CONTRIBUTING.md を、リポジトリのコーディング規約については AGENTS.md を参照してください。
OpenShell はプロジェクトの改善に役立てるため、運用カテゴリとその件数に限定した匿名テレメトリを収集します。サンドボックス名、ホスト名、ファイルパス、プロンプト、認証情報、プロバイダー名やモデル名、ユーザーコンテンツは収集しません。無効にするには、ゲートウェイで OPENSHELL_TELEMETRY_ENABLED=false を設定するか、Helm インストールの場合は server.telemetryEnabled=false を設定します。テレメトリを完全にコンパイルから除外することもできます。詳細は Telemetry を、公開されている利用動向についてはコミュニティテレメトリレポートを参照してください。
本ソフトウェアは、外部の素材を自動的に取得、アクセス、または操作します。取得された素材は本ソフトウェアとともに配布されるものではなく、別個の条項、条件、およびライセンスによってのみ管理されます。適用されるすべての条項、条件、およびライセンスを見つけ、確認し、遵守すること、ならびに取得された素材がお客様の特定のユースケースに対して安全で、完全で、適切であることを検証することは、お客様の単独の責任です。本ソフトウェアは「現状のまま」提供され、いかなる種類の保証も伴いません。作者は、取得された素材に関していかなる表明も保証も行わず、本ソフトウェアまたは取得された素材の使用または使用不能から生じるいかなる損失、損害、責任、または法的結果についても責任を負いません。本ソフトウェアおよび取得された素材は、お客様自身の責任で使用してください。
このプロジェクトは Apache License 2.0 の下でライセンスされています。