OpenShell

[!IMPORTANT] Novità in OpenShell 0.1.x: una cadenza di rilascio stabile, nuove primitive di isolamento, una superficie di estensione ampliata e nuove API. Leggi la guida all'aggiornamento 0.1.0.

OpenShell è il runtime sicuro e privato per flotte di agenti AI autonomi. Gli agenti sono più utili quando possono leggere file, installare pacchetti, chiamare API e utilizzare credenziali. OpenShell fornisce loro questa capacità senza concedere accesso illimitato ai tuoi dati, segreti o rete. Dichiari a cosa può accedere ciascun agente in una policy, e OpenShell la applica.

Come funziona

OpenShell governa ciò che gli agenti possono fare in due modi: strumenta il kernel per applicare la policy su ogni accesso a file, chiamata di sistema e connessione di rete a runtime, e utilizza la verifica formale per controllare cosa consentirebbe una modifica di policy prima che venga applicata.

• Applicazione a livello kernel. Ogni agente viene eseguito in una sandbox isolata. I controlli del kernel limitano quali file può accedere e quali chiamate di sistema può effettuare, e ogni connessione di rete passa attraverso un controllo di policy prima di uscire dalla sandbox. Gli agenti non vedono mai le credenziali reali; OpenShell le aggiunge solo alle richieste destinate a endpoint approvati.
• Modifiche di policy formalmente verificate. Prima che una modifica di policy venga approvata, OpenShell utilizza la verifica formale per segnalare i nuovi accessi rischiosi che concederebbe, come raggiungere un nuovo host con credenziali o chiamare un nuovo metodo API, in modo che tali modifiche attendano la revisione umana.

Consulta Architecture per capire come gateway, supervisor e sandbox si integrano tra loro.

Avvio rapido

Hai bisogno di Linux, macOS su Apple Silicon o Windows con WSL 2 (sperimentale), oltre a Docker, Podman o virtualizzazione host. Consulta la Support Matrix per i dettagli.

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo

L'installer configura la CLI e un gateway locale. L'immagine sandbox predefinita è un Ubuntu minimale senza alcun agente installato. Per eseguire un agente reale, segui Run Your First Agent: esegue OpenCode con un modello OpenRouter gratuito e mostra come approvare nuovi accessi man mano che l'agente ne ha bisogno.

Esplora ulteriormente

• Sandboxes: immagini, runtime, GPU e ciclo di vita.
• Policies: regole per filesystem, rete e processi, con l'advisor e il prover per la revisione delle modifiche.
• Providers: credenziali che funzionano solo su endpoint approvati, inclusa l'inference.
• Gateways: il control plane per sandbox, policy e accesso.
• Kubernetes: distribuisci il gateway con Helm. Il tuo CNI deve applicare NetworkPolicy.
• Extensibility: middleware, intercettori e driver di calcolo.
• Tutorials: procedure dettagliate su policy e agenti.
• Prerelease and development builds: prova una release imminente o l'ultimo commit su main.

Agent Skills

Installa le skill pubbliche di OpenShell per il tuo agente di coding:

npx skills add NVIDIA/OpenShell

Le skill insegnano al tuo agente a usare la CLI di OpenShell, scrivere policy per le sandbox e fare debug di gateway e routing dell'inference. Si trovano in skills/ e funzionano senza un checkout del codice sorgente di OpenShell.

SDK

Gli SDK connettono le applicazioni a un gateway OpenShell. Non installano la CLI. Usa la stessa release di OpenShell per l'SDK e il gateway quando possibile.

Linguaggio	Installazione	Documentazione
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 and usage

Community

• Domande e discussioni: GitHub Discussions
• Segnalazioni di bug e richieste di funzionalità: GitHub Issues, utilizzando i template delle issue
• Vulnerabilità di sicurezza: segui SECURITY.md. Non aprire una issue su GitHub.
• Roadmap: OpenShell Roadmap e la RFC board
• Provalo nel cloud: Brev Launchable

OpenShell è costruito agent-first: viene sviluppato con gli stessi flussi di lavoro guidati dagli agenti che abilita. Consulta CONTRIBUTING.md per la configurazione dello sviluppo e il flusso di contribuzione, e AGENTS.md per le convenzioni di coding del repository.

Telemetria