OpenShell v0.1.5
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.
Funktionsweise
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.
- Durchsetzung auf Kernel-Ebene. Jeder Agent läuft in einer isolierten Sandbox. Kernel-Kontrollen beschränken, auf welche Dateien er zugreifen und welche Systemaufrufe er ausführen kann, und jede Netzwerkverbindung durchläuft eine Richtlinienprüfung, bevor sie die Sandbox verlässt. Agenten sehen niemals echte Anmeldedaten; OpenShell fügt sie nur zu Anfragen hinzu, die an genehmigte Endpunkte gebunden sind.
- Formal verifizierte Richtlinienänderungen. Bevor eine Richtlinienänderung genehmigt wird, verwendet OpenShell formale Verifikation, um riskante neue Zugriffe zu kennzeichnen, die sie gewähren würde, wie etwa das Erreichen eines neuen Hosts mit Anmeldedaten oder das Aufrufen einer neuen API-Methode, sodass diese Änderungen auf eine menschliche Überprüfung warten.
Siehe Architektur für das Zusammenspiel von Gateway, Supervisor und Sandbox.
Schnellstart
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.
Weiter erkunden
- Sandboxes: Images, Laufzeitumgebungen, GPUs und Lebenszyklus.
- Policies: Dateisystem-, Netzwerk- und Prozessregeln, mit dem Advisor und Prover zur Überprüfung von Änderungen.
- Providers: Anmeldedaten, die nur an genehmigten Endpunkten funktionieren, einschließlich Inferenz.
- Gateways: die Steuerungsebene für Sandboxes, Richtlinien und Zugriff.
- Kubernetes: Stelle das Gateway mit Helm bereit. Dein CNI muss
NetworkPolicydurchsetzen. - Erweiterbarkeit: Middleware, Interceptors und Compute-Treiber.
- Tutorials: Schritt-für-Schritt-Anleitungen zu Richtlinien und Agenten.
- Vorab- und Entwicklungs-Builds: Probiere ein kommendes Release oder den neuesten Commit auf
mainaus.
Agent Skills
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
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 |
Community
- Fragen und Diskussion: GitHub Discussions
- Fehlerberichte und Funktionswünsche: GitHub Issues, unter Verwendung der Issue-Vorlagen
- Sicherheitslücken: folge SECURITY.md. Öffne kein GitHub-Issue.
- Roadmap: OpenShell Roadmap und das RFC-Board
- In der Cloud ausprobieren: Brev Launchable
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.