
Sandbox-Laufzeitumgebung für autonome KI-Agenten mit deklarativen YAML-Richtlinien, die Dateisystem-, Netzwerk- und Prozessbeschränkungen durchsetzen, sowie endpunktgebundener Anmeldedaten-Injektion.
[!IMPORTANT] Neu in OpenShell 0.1.x: ein stabiler Release-Rhythmus, neue Isolationsprimitive, eine erweiterte Erweiterungsoberfläche und neue APIs. Lies den Upgrade-Leitfaden für 0.1.0.
OpenShell ist die sichere, private Laufzeitumgebung für Flotten autonomer KI-Agenten. Agenten sind am nützlichsten, wenn sie Dateien lesen, Pakete installieren, APIs aufrufen und Anmeldedaten verwenden können. OpenShell gibt ihnen diese Fähigkeit, ohne ihnen uneingeschränkten Zugriff auf deine Daten, Geheimnisse oder dein Netzwerk zu gewähren. Du deklarierst in einer Richtlinie, worauf jeder Agent zugreifen darf, und OpenShell setzt dies durch.
OpenShell steuert, was Agenten tun können, auf zwei Arten: Es instrumentiert den Kernel, um die Richtlinie bei jedem Dateizugriff, Systemaufruf und jeder Netzwerkverbindung zur Laufzeit durchzusetzen, und es verwendet formale Verifikation, um zu prüfen, was eine Richtlinienänderung erlauben würde, bevor sie angewendet wird.
Siehe Architektur für das Zusammenspiel von Gateway, Supervisor und Sandbox.
Du benötigst Linux, macOS auf Apple Silicon oder Windows mit WSL 2 (experimentell), plus Docker, Podman oder Host-Virtualisierung. Siehe die Support-Matrix für Details.
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
Der Installer richtet die CLI und ein lokales Gateway ein. Das Standard-Sandbox-Image ist ein minimales Ubuntu ohne installierten Agenten. Um einen echten Agenten auszuführen, folge Führe deinen ersten Agenten aus: Es führt OpenCode gegen ein kostenloses OpenRouter-Modell aus und zeigt, wie du neuen Zugriff genehmigst, wenn der Agent ihn benötigt.
NetworkPolicy durchsetzen.main aus.Installiere die öffentlichen OpenShell-Skills für deinen Coding-Agenten:
npx skills add NVIDIA/OpenShell
Die Skills bringen deinem Agenten bei, die OpenShell-CLI zu steuern, Sandbox-Richtlinien zu schreiben und Gateways sowie Inferenz-Routing zu debuggen. Sie befinden sich in skills/ und funktionieren ohne einen OpenShell-Quellcode-Checkout.
SDKs verbinden Anwendungen mit einem OpenShell-Gateway. Sie installieren nicht die CLI. Verwende nach Möglichkeit dasselbe OpenShell-Release für das SDK und das Gateway.
| Sprache | Installation | Docs |
|---|---|---|
| Python | uv add openshell | README |
| TypeScript | npm install @nvidia/openshell-sdk (GitHub Packages) | README |
| Go | go get github.com/NVIDIA/OpenShell/sdk/go@latest | README |
| Rust | cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag> | Installation und Verwendung |
OpenShell ist agent-first konzipiert: Es wird mit denselben agentengesteuerten Workflows entwickelt, die es ermöglicht. Siehe CONTRIBUTING.md für die Entwicklungseinrichtung und den Beitrags-Workflow sowie AGENTS.md für die Coding-Konventionen des Repositorys.