Sandbox-Laufzeitumgebung für autonome KI-Agenten mit deklarativen YAML-Richtlinien, die Dateisystem-, Netzwerk- und Prozessbeschränkungen durchsetzen, sowie endpunktgebundener Anmeldedaten-Injektion.
[!NOTE] 🚧 OpenShell ist jetzt Teil der CNCF! Wir sind dabei, die Entwicklung nach ai-openshell und die Governance an die CNCF zu übertragen. Bis der Umzug abgeschlossen ist, verwenden Sie bitte weiterhin das Repository NVIDIA/OpenShell für Code, Issues und Pull Requests.
[!IMPORTANT] Neu in OpenShell 0.1.x: ein stabiler Release-Rhythmus, neue Isolationsprimitive, eine erweiterte Erweiterungsoberfläche und neue APIs. Lesen Sie 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 verleiht ihnen diese Fähigkeiten, ohne ihnen uneingeschränkten Zugriff auf Ihre Daten, Geheimnisse oder Ihr Netzwerk zu gewähren. Sie legen in einer Richtlinie fest, 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.
Unter Architecture erfahren Sie, wie Gateway, Supervisor und Sandbox zusammenwirken.
Sie benötigen Linux, macOS auf Apple Silicon oder Windows mit WSL 2 (experimentell) sowie Docker, Podman oder Host-Virtualisierung. Einzelheiten finden Sie in der Support Matrix.
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 Agent. Um einen echten Agent auszuführen, folge Run Your First Agent: Es führt OpenCode gegen ein kostenloses OpenRouter-Modell aus und zeigt, wie du neuen Zugriff genehmigst, wenn der Agent ihn benötigt.
Für native Windows-Unterstützung über Microsoft MXC siehe den Windows build and runtime guide für die Einrichtung und aktuelle Einschränkungen.
NetworkPolicy durchsetzen.main.Installiere die öffentlichen OpenShell-Skills für deinen Coding-Agent:
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 liegen 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 dieselbe OpenShell-Version für das SDK und das Gateway.
| Sprache | Installation | Dokumentation |
|---|---|---|
| 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> | Installation und Verwendung |