OpenShell v0.1.6
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 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 fornisce loro questa capacità senza concedere accesso illimitato ai tuoi dati, segreti o rete. Dichiari cosa ogni agente può toccare 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 ai file, chiamata di sistema e connessione di rete a runtime, e usa la verifica formale per controllare cosa consentirebbe una modifica alla policy prima che venga applicata.
- Applicazione a livello di 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 della policy prima di uscire dalla sandbox. Gli agenti non vedono mai credenziali reali; OpenShell le aggiunge solo alle richieste destinate a endpoint approvati.
- Modifiche alla policy formalmente verificate. Prima che una modifica alla policy venga approvata, OpenShell usa la verifica formale per segnalare i nuovi accessi rischiosi che concederebbe, come raggiungere un nuovo host con credenziali o chiamare un nuovo metodo API, così che tali modifiche attendano la revisione umana.
Vedi Architecture per capire come gateway, supervisor e sandbox si integrano tra loro.
Quickstart
Hai bisogno di Linux, macOS su Apple Silicon, o Windows con WSL 2 (sperimentale), oltre a Docker, Podman o virtualizzazione host. Vedi 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.
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, interceptor e driver di calcolo.
- Tutorials: procedure dettagliate passo passo su policy e agent.
- 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 coding agent:
npx skills add NVIDIA/OpenShell
Le skill 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 codice sorgente di OpenShell.
SDK
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/NVIDIA/OpenShell/sdk/go@latest | README |
| Rust | cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag> | Installazione e utilizzo |
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 è progettato agent-first: viene sviluppato con gli stessi workflow guidati dagli agenti che abilita. Consulta CONTRIBUTING.md per la configurazione dello sviluppo e il workflow di contribuzione, e AGENTS.md per le convenzioni di codifica del repository.