Runtime sandboxed per agenti AI autonomi con policy YAML dichiarative che applicano vincoli su filesystem, rete e processi, oltre all'iniezione di credenziali vincolate all'endpoint.
[!NOTE] 🚧 OpenShell ora fa parte della CNCF! Stiamo trasferendo lo sviluppo su ai-openshell e la governance alla CNCF. Fino al completamento del trasferimento, continuate a utilizzare il repository NVIDIA/OpenShell per codice, issue e pull request.
[!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 a 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 usare credenziali. OpenShell conferisce loro questa capacità senza concedere accesso illimitato ai tuoi dati, segreti o rete. Dichiari ciò che ogni agente può toccare in una policy, e OpenShell la applica.
OpenShell governa ciò che gli agenti possono fare in due modi: strumenta il kernel per applicare la policy su ogni accesso ai file, chiamata di sistema e connessione di rete a runtime, e utilizza la verifica formale per controllare cosa consentirebbe una modifica alla policy prima che venga applicata.
Consulta Architecture per capire come gateway, supervisor e sandbox si integrano tra loro.
È necessario Linux, macOS su Apple Silicon oppure 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 agent installato. Per eseguire un agent reale, segui Run Your First Agent: esegue OpenCode con un modello OpenRouter gratuito e mostra come approvare nuovi accessi man mano che l'agent ne ha bisogno.
Per il supporto nativo Windows tramite Microsoft MXC, consulta la guida alla build e al runtime per Windows per la configurazione e le limitazioni attuali.
NetworkPolicy.main.Installa le skill pubbliche di OpenShell per il tuo coding agent:
npx skills add NVIDIA/OpenShell
Le skills insegnano al tuo agente a pilotare la CLI di OpenShell, a scrivere policy per le sandbox e a fare debug di gateway e routing dell'inferenza. Si trovano in skills/ e funzionano senza un checkout del sorgente di OpenShell.
Gli SDK collegano le applicazioni a un gateway OpenShell. Non installano la CLI. Quando possibile, usa la stessa release di OpenShell per l'SDK e per il gateway.
| Linguaggio | Installazione | Documentazione |
|---|---|---|
| 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> | Installazione e utilizzo |