OpenShell v0.1.5
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.
[!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.