OpenShell is een beveiligde runtime specifiek ontwikkeld voor vloten van autonome AI-agents. Het stelt agents in staat om taken uit te voeren zoals het lezen van bestanden en het aanroepen van API's, terwijl de toegang tot gevoelige gegevens en netwerken strikt wordt beperkt via gedefinieerde policies.
De belangrijkste technische kenmerken zijn:
- Kernel-level handhaving: Agents draaien in geïsoleerde sandboxes waarbij elke systeemoproep en netwerkverbinding wordt gecontroleerd.
- Formele verificatie: Nieuwe beleidswijzigingen worden geanalyseerd op risico's voordat ze door een mens worden goedgekeurd.
- Compatibiliteit: Het ondersteunt Linux, macOS (Apple Silicon) en Windows (via WSL 2), en kan worden geïmplementeerd via Docker, Podman of Kubernetes.
OpenShell biedt SDK's voor Python, TypeScript, Go en Rust, en beschikt over specifieke 'skills' die AI-agents leren hoe ze de CLI en het beleid moeten beheren. Het project is gelicentieerd onder de Apache License 2.0.
OpenShell
OpenShell is de veilige, private runtime voor vloten van autonome AI-agents. Agents zijn het meest nuttig wanneer ze bestanden kunnen lezen, pakketten kunnen installeren, API's kunnen aanroepen en inloggegevens kunnen gebruiken. OpenShell geeft hen deze mogelijkheden zonder dat ze onbeperkte toegang krijgen tot uw gegevens, geheimen of netwerk. U definieert in een beleid (policy) wat elke agent mag aanraken, en OpenShell handhaaft dit.
Hoe het werkt
OpenShell beheert wat agents kunnen doen op twee manieren: het instrumenteert de kernel om het beleid bij elke bestandsactie, systeemoproep en netwerkverbinding tijdens de runtime te handhaven, en het maakt gebruik van formele verificatie om te controleren wat een wijziging in het beleid zou toestaan voordat deze wordt toegepast.
Handhaving op kernelniveau
Elke agent draait in een geïsoleerde sandbox. Kernelcontroles beperken welke bestanden de agent kan openen en welke systeemoproepen hij kan maken. Elke netwerkverbinding gaat door een beleidscontrole voordat deze de sandbox verlaat. Agents zien nooit echte inloggegevens; OpenShell voegt deze alleen toe aan verzoeken die bestemd zijn voor goedgekeurde eindpunten.
Formeel geverifieerde beleidswijzigingen
Voordat een wijziging in het beleid wordt goedgekeurd, gebruikt OpenShell formele verificatie om risicovolle nieuwe toegangen te markeren die hiermee zouden worden verleend — zoals het bereiken van een nieuwe host met inloggegevens of het aanroepen van een nieuwe API-methode. Deze wijzigingen wachten vervolgens op menselijke beoordeling.
Zie 'Architectuur' voor meer informatie over hoe de gateway, supervisor en sandbox samenwerken.
Snelstart
U heeft Linux, macOS op Apple Silicon, of Windows met WSL 2 (experimenteel) nodig, samen met Docker, Podman of host-virtualisatie. Raadpleeg de Support Matrix voor details.
Installatie:
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
Een sandbox maken:
openshell sandbox create --name demo
De installer configureert de CLI en een lokale gateway. Het standaard sandbox-image is een minimale Ubuntu-installatie zonder geïnstalleerde agent. Om een echte agent te draaien, volgt u "Run Your First Agent": dit draait OpenCode tegen een gratis OpenRouter-model en laat zien hoe u nieuwe toegang goedkeurt wanneer de agent dit nodig heeft.
Verder verkennen
- Sandboxes: Images, runtimes, GPU's en levenscyclus.
- Policies: Regels voor het bestandssysteem, netwerk en processen, inclusief de advisor en prover voor het beoordelen van wijzigingen.
- Providers: Inloggegevens die alleen werken op goedgekeurde eindpunten, inclusief inferentie.
- Gateways: Het beheersvlak (control plane) voor sandboxes, beleid en toegang.
- Kubernetes: Implementeer de gateway met Helm. Uw CNI moet NetworkPolicy handhaven.
- Extensibility: Middleware, interceptors en compute-drivers.
- Tutorials: Stapsgewijze handleidingen voor beleid en agents.
- Prerelease en ontwikkelversies: Probeer een aanstaande release of de nieuwste commit op de main-branch.
Agent Skills
Installeer de publieke OpenShell-vaardigheden voor uw coding-agent:
npx skills add NVIDIA/OpenShell
Deze vaardigheden leren uw agent hoe hij de OpenShell CLI moet bedienen, sandbox-beleid moet schrijven en gateways en inferentie-routing moet debuggen. Ze bevinden zich in de map skills/ en werken zonder dat een OpenShell-source checkout nodig is.
SDK's
SDK's verbinden applicaties met een OpenShell-gateway. Ze installeren de CLI niet. Gebruik indien mogelijk dezelfde OpenShell-release voor zowel de SDK als de gateway.
| Taal | Installatie | Documentatie |
|---|
| 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> | Installatie en gebruik |
Community
- Vragen en discussie: GitHub Discussions
- Bugrapporten en feature-verzoeken: GitHub Issues (gebruik de issue-templates)
- Beveiligingskwetsbaarheden: Volg
SECURITY.md. Open geen GitHub-issue.
- Roadmap: OpenShell Roadmap en het RFC-bord
- Probeer het in de cloud: Brev Launchable
OpenShell is 'agent-first' gebouwd: het is ontwikkeld met dezelfde agent-gestuurde workflows die het faciliteert. Zie CONTRIBUTING.md voor de ontwikkelset-up en de bijdrage-workflow, en AGENTS.md voor de codeconventies van de repository.
Telemetrie
OpenShell verzamelt anonieme telemetrie, beperkt tot operationele categorieën en aantallen, om het project te helpen verbeteren. Het verzamelt geen sandbox-namen, hostnames, bestandspaden, prompts, inloggegevens, provider- of modelnamen, of gebruikersinhoud.
Om dit uit te schakelen, kunt u OPENSHELLTELEMETRYENABLED=false instellen op de gateway, of server.telemetryEnabled=false bij Helm-installaties. U kunt telemetrie ook volledig uit de compilatie verwijderen. Zie 'Telemetry' voor details en de community-telemetrieverslagen voor gepubliceerde gebruikstrends.
Kennisgeving en Disclaimer
Deze software haalt automatisch externe materialen op, benadert deze of communiceert ermee. Deze opgehaalde materialen worden niet gedistribueerd met deze software en worden uitsluitend beheerst door afzonderlijke voorwaarden, bepalingen en licenties. U bent uitsluitend verantwoordelijk voor het vinden, beoordelen en naleven van alle toepasselijke voorwaarden, bepalingen en licenties, en voor het verifiëren van de beveiliging, integriteit en geschiktheid van eventuele opgehaalde materialen voor uw specifieke use case. Deze software wordt geleverd "AS IS", zonder enige vorm van garantie. De auteur doet geen verklaringen of garanties met betrekking tot eventuele opgehaalde materialen en aanvaardt geen aansprakelijkheid voor enig verlies, schade, verplichtingen of juridische gevolgen voortvloeiend uit uw gebruik of onvermogen om deze software of eventuele opgehaalde materialen te gebruiken. Gebruik deze software en de opgehaalde materialen op eigen risico.
Licentie
Dit project is gelicentieerd onder de Apache License 2.0.
OpenShell
OpenShell is de veilige, private runtime voor vloten van autonome AI-agents. Agents zijn het meest nuttig wanneer ze bestanden kunnen lezen, pakketten kunnen installeren, API's kunnen aanroepen en inloggegevens kunnen gebruiken. OpenShell geeft hen deze mogelijkheden zonder dat ze onbeperkte toegang krijgen tot uw gegevens, geheimen of netwerk. U definieert in een beleid (policy) wat elke agent mag aanraken, en OpenShell handhaaft dit.
Hoe het werkt
OpenShell beheert wat agents kunnen doen op twee manieren: het instrumenteert de kernel om het beleid bij elke bestandsactie, systeemoproep en netwerkverbinding tijdens de runtime te handhaven, en het maakt gebruik van formele verificatie om te controleren wat een wijziging in het beleid zou toestaan voordat deze wordt toegepast.
Handhaving op kernelniveau
Elke agent draait in een geïsoleerde sandbox. Kernelcontroles beperken welke bestanden de agent kan openen en welke systeemoproepen hij kan maken. Elke netwerkverbinding gaat door een beleidscontrole voordat deze de sandbox verlaat. Agents zien nooit echte inloggegevens; OpenShell voegt deze alleen toe aan verzoeken die bestemd zijn voor goedgekeurde eindpunten.
Formeel geverifieerde beleidswijzigingen
Voordat een wijziging in het beleid wordt goedgekeurd, gebruikt OpenShell formele verificatie om risicovolle nieuwe toegangen te markeren die hiermee zouden worden verleend — zoals het bereiken van een nieuwe host met inloggegevens of het aanroepen van een nieuwe API-methode. Deze wijzigingen wachten vervolgens op menselijke beoordeling.
Zie 'Architectuur' voor meer informatie over hoe de gateway, supervisor en sandbox samenwerken.
Snelstart
U heeft Linux, macOS op Apple Silicon, of Windows met WSL 2 (experimenteel) nodig, samen met Docker, Podman of host-virtualisatie. Raadpleeg de Support Matrix voor details.
Installatie:
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
Een sandbox maken:
openshell sandbox create --name demo
De installer configureert de CLI en een lokale gateway. Het standaard sandbox-image is een minimale Ubuntu-installatie zonder geïnstalleerde agent. Om een echte agent te draaien, volgt u "Run Your First Agent": dit draait OpenCode tegen een gratis OpenRouter-model en laat zien hoe u nieuwe toegang goedkeurt wanneer de agent dit nodig heeft.
Verder verkennen
- Sandboxes: Images, runtimes, GPU's en levenscyclus.
- Policies: Regels voor het bestandssysteem, netwerk en processen, inclusief de advisor en prover voor het beoordelen van wijzigingen.
- Providers: Inloggegevens die alleen werken op goedgekeurde eindpunten, inclusief inferentie.
- Gateways: Het beheersvlak (control plane) voor sandboxes, beleid en toegang.
- Kubernetes: Implementeer de gateway met Helm. Uw CNI moet NetworkPolicy handhaven.
- Extensibility: Middleware, interceptors en compute-drivers.
- Tutorials: Stapsgewijze handleidingen voor beleid en agents.
- Prerelease en ontwikkelversies: Probeer een aanstaande release of de nieuwste commit op de main-branch.
Agent Skills
Installeer de publieke OpenShell-vaardigheden voor uw coding-agent:
npx skills add NVIDIA/OpenShell
Deze vaardigheden leren uw agent hoe hij de OpenShell CLI moet bedienen, sandbox-beleid moet schrijven en gateways en inferentie-routing moet debuggen. Ze bevinden zich in de map skills/ en werken zonder dat een OpenShell-source checkout nodig is.
SDK's
SDK's verbinden applicaties met een OpenShell-gateway. Ze installeren de CLI niet. Gebruik indien mogelijk dezelfde OpenShell-release voor zowel de SDK als de gateway.
| Taal | Installatie | Documentatie |
|---|
| 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> | Installatie en gebruik |
Community
- Vragen en discussie: GitHub Discussions
- Bugrapporten en feature-verzoeken: GitHub Issues (gebruik de issue-templates)
- Beveiligingskwetsbaarheden: Volg
SECURITY.md. Open geen GitHub-issue.
- Roadmap: OpenShell Roadmap en het RFC-bord
- Probeer het in de cloud: Brev Launchable
OpenShell is 'agent-first' gebouwd: het is ontwikkeld met dezelfde agent-gestuurde workflows die het faciliteert. Zie CONTRIBUTING.md voor de ontwikkelset-up en de bijdrage-workflow, en AGENTS.md voor de codeconventies van de repository.
Telemetrie
OpenShell verzamelt anonieme telemetrie, beperkt tot operationele categorieën en aantallen, om het project te helpen verbeteren. Het verzamelt geen sandbox-namen, hostnames, bestandspaden, prompts, inloggegevens, provider- of modelnamen, of gebruikersinhoud.
Om dit uit te schakelen, kunt u OPENSHELLTELEMETRYENABLED=false instellen op de gateway, of server.telemetryEnabled=false bij Helm-installaties. U kunt telemetrie ook volledig uit de compilatie verwijderen. Zie 'Telemetry' voor details en de community-telemetrieverslagen voor gepubliceerde gebruikstrends.
Kennisgeving en Disclaimer
Deze software haalt automatisch externe materialen op, benadert deze of communiceert ermee. Deze opgehaalde materialen worden niet gedistribueerd met deze software en worden uitsluitend beheerst door afzonderlijke voorwaarden, bepalingen en licenties. U bent uitsluitend verantwoordelijk voor het vinden, beoordelen en naleven van alle toepasselijke voorwaarden, bepalingen en licenties, en voor het verifiëren van de beveiliging, integriteit en geschiktheid van eventuele opgehaalde materialen voor uw specifieke use case. Deze software wordt geleverd "AS IS", zonder enige vorm van garantie. De auteur doet geen verklaringen of garanties met betrekking tot eventuele opgehaalde materialen en aanvaardt geen aansprakelijkheid voor enig verlies, schade, verplichtingen of juridische gevolgen voortvloeiend uit uw gebruik of onvermogen om deze software of eventuele opgehaalde materialen te gebruiken. Gebruik deze software en de opgehaalde materialen op eigen risico.
Licentie
Dit project is gelicentieerd onder de Apache License 2.0.
Groetjes,