Sandbox-Laufzeitumgebung für autonome KI-Agenten mit deklarativen YAML-Richtlinien, die Dateisystem-, Netzwerk- und Prozessbeschränkungen durchsetzen, sowie endpunktgebundener Anmeldedaten-Injektion.
<!-- markdownlint-disable MD033 MD041 --> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/brand/assets/openshell-banner-dark.png"> <source media="(prefers-color-scheme: light)" srcset="docs/brand/assets/openshell-banner-light.png"> <img alt="OpenShell" src="https://assets.kitploit.com/production/public/readmes/55422/c804e19d2b22bb79cb299fe8da06482346c588c833ad4342ea6668f7e4f1ec6e/224fe7d3f9d8bb5110e1543695d8e28bdf42ef37ce269e338709d8ea6f94fa6e-display-v1.webp" width="430"> </picture> <!-- markdownlint-enable MD033 MD041 --> [](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE) [](https://pypi.org/project/openshell/) [](SECURITY.md) [](https://docs.nvidia.com/openshell/latest/index.html) > [!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](https://docs.nvidia.com/openshell/latest/upgrade/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](https://docs.nvidia.com/openshell/latest/about/architecture) 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](https://docs.nvidia.com/openshell/latest/about/support-matrix) für Details. ```shell 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](https://docs.nvidia.com/openshell/latest/about/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. ## Weiter erkunden - [Sandboxes](https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview): Images, Laufzeitumgebungen, GPUs und Lebenszyklus. - [Policies](https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview): Dateisystem-, Netzwerk- und Prozessregeln, mit dem [Advisor](https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) und [Prover](https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) zur Überprüfung von Änderungen. - [Providers](https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview): Anmeldedaten, die nur an genehmigten Endpunkten funktionieren, einschließlich [Inferenz](https://docs.nvidia.com/openshell/latest/how-it-works/inference). - [Gateways](https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview): die Steuerungsebene für Sandboxes, Richtlinien und Zugriff. - [Kubernetes](https://docs.nvidia.com/openshell/latest/kubernetes/setup): Stelle das Gateway mit Helm bereit. Dein CNI muss `NetworkPolicy` durchsetzen. - [Erweiterbarkeit](https://docs.nvidia.com/openshell/latest/extensibility/overview): Middleware, Interceptors und Compute-Treiber. - [Tutorials](https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy): Schritt-für-Schritt-Anleitungen zu Richtlinien und Agenten. - [Vorab- und Entwicklungs-Builds](https://docs.nvidia.com/openshell/latest/about/installation#prerelease-and-development-builds): Probiere ein kommendes Release oder den neuesten Commit auf `main` aus. ## Agent Skills Installiere die öffentlichen OpenShell-Skills für deinen Coding-Agenten: ```shell 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/`](https://github.com/nvidia/openshell/blob/main/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](https://github.com/nvidia/openshell/blob/main/python/openshell) | | TypeScript | `npm install @nvidia/openshell-sdk` (GitHub Packages) | [README](https://github.com/nvidia/openshell/blob/main/sdk/typescript/README.md) | | Go | `go get github.com/NVIDIA/OpenShell/sdk/go@latest` | [README](https://github.com/nvidia/openshell/blob/main/sdk/go/README.md) | | Rust | `cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag>` | [Installation und Verwendung](https://github.com/nvidia/openshell/blob/main/docs/sdk/rust.mdx) | ## Community - **Fragen und Diskussion:** [GitHub Discussions](https://github.com/NVIDIA/OpenShell/discussions) - **Fehlerberichte und Funktionswünsche:** [GitHub Issues](https://github.com/NVIDIA/OpenShell/issues), unter Verwendung der Issue-Vorlagen - **Sicherheitslücken:** folge [SECURITY.md](https://github.com/nvidia/openshell/blob/main/SECURITY.md). Öffne kein GitHub-Issue. - **Roadmap:** [OpenShell Roadmap](https://github.com/orgs/NVIDIA/projects/233) und das [RFC-Board](https://github.com/orgs/NVIDIA/projects/233/views/6) - **In der Cloud ausprobieren:** [Brev Launchable](https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg) OpenShell ist agent-first konzipiert: Es wird mit denselben agentengesteuerten Workflows entwickelt, die es ermöglicht. Siehe [CONTRIBUTING.md](https://github.com/nvidia/openshell/blob/main/CONTRIBUTING.md) für die Entwicklungseinrichtung und den Beitrags-Workflow sowie [AGENTS.md](https://github.com/nvidia/openshell/blob/main/AGENTS.md) für die Coding-Konventionen des Repositorys. ## Telemetrie OpenShell erfasst anonyme Telemetrie, beschränkt auf operative Kategorien und Zählungen, um zur Verbesserung des Projekts beizutragen. Es werden keine Sandbox-Namen, Hostnamen, Dateipfade, Prompts, Anmeldedaten, Provider- oder Modellnamen oder Nutzerinhalte erfasst. Um sie zu deaktivieren, setze `OPENSHELL_TELEMETRY_ENABLED=false` auf dem Gateway oder `server.telemetryEnabled=false` für Helm-Installationen. Du kannst die Telemetrie auch vollständig herauskompilieren. Siehe [Telemetrie](https://docs.nvidia.com/openshell/latest/observability/telemetry) für Details und die [Community-Telemetrieberichte](https://github.com/nvidia/openshell/blob/main/telemetry/README.md) für veröffentlichte Nutzungstrends. ## Hinweis und Haftungsausschluss Diese Software ruft automatisch externe Materialien ab, greift darauf zu oder interagiert mit ihnen. Diese abgerufenen Materialien werden nicht mit dieser Software vertrieben und unterliegen ausschließlich separaten Bedingungen und Lizenzen. Du bist allein dafür verantwortlich, alle geltenden Bedingungen und Lizenzen zu finden, zu prüfen und einzuhalten sowie die Sicherheit, Integrität und Eignung aller abgerufenen Materialien für deinen spezifischen Anwendungsfall zu überprüfen. Diese Software wird „AS IS“ bereitgestellt, ohne jegliche Gewährleistung. Der Autor gibt keine Zusicherungen oder Gewährleistungen in Bezug auf abgerufene Materialien und übernimmt keine Haftung für Verluste, Schäden, Verbindlichkeiten oder rechtliche Konsequenzen aus deiner Nutzung oder Unfähigkeit zur Nutzung dieser Software oder abgerufener Materialien. Nutze diese Software und die abgerufenen Materialien auf eigenes Risiko. ## Lizenz Dieses Projekt ist unter der [Apache License 2.0](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE) lizenziert.
