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.
<!-- markdownlint-disable MD033 MD041 --> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/brand/assets/openshell-banner-dark.png"> <source media="(prefers-color-scheme: light)" srcset="docs/brand/assets/openshell-banner-light.png"> <img alt="OpenShell" src="https://assets.kitploit.com/production/public/readmes/55422/c804e19d2b22bb79cb299fe8da06482346c588c833ad4342ea6668f7e4f1ec6e/224fe7d3f9d8bb5110e1543695d8e28bdf42ef37ce269e338709d8ea6f94fa6e-display-v1.webp" width="430"> </picture> <!-- markdownlint-enable MD033 MD041 --> [](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE) [](https://pypi.org/project/openshell/) [](SECURITY.md) [](https://docs.nvidia.com/openshell/latest/index.html) > [!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](https://docs.nvidia.com/openshell/latest/upgrade/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](https://docs.nvidia.com/openshell/latest/about/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](https://docs.nvidia.com/openshell/latest/about/support-matrix) per i dettagli. ```shell 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](https://docs.nvidia.com/openshell/latest/about/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](https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview): immagini, runtime, GPU e ciclo di vita. - [Policies](https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview): regole per filesystem, rete e processi, con l'[advisor](https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) e il [prover](https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) per la revisione delle modifiche. - [Providers](https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview): credenziali che funzionano solo su endpoint approvati, inclusa l'[inference](https://docs.nvidia.com/openshell/latest/how-it-works/inference). - [Gateways](https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview): il control plane per sandbox, policy e accesso. - [Kubernetes](https://docs.nvidia.com/openshell/latest/kubernetes/setup): distribuisci il gateway con Helm. Il tuo CNI deve applicare `NetworkPolicy`. - [Extensibility](https://docs.nvidia.com/openshell/latest/extensibility/overview): middleware, intercettori e driver di calcolo. - [Tutorials](https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy): procedure dettagliate su policy e agenti. - [Prerelease and development builds](https://docs.nvidia.com/openshell/latest/about/installation#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: ```shell 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/`](https://github.com/nvidia/openshell/blob/main/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](https://github.com/nvidia/openshell/blob/main/python/openshell) | | TypeScript | `npm install @nvidia/openshell-sdk` (GitHub Packages) | [README](https://github.com/nvidia/openshell/blob/main/sdk/typescript/README.md) | | Go | `go get github.com/NVIDIA/OpenShell/sdk/go@latest` | [README](https://github.com/nvidia/openshell/blob/main/sdk/go/README.md) | | Rust | `cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag>` | [Installation and usage](https://github.com/nvidia/openshell/blob/main/docs/sdk/rust.mdx) | ## Community - **Domande e discussioni:** [GitHub Discussions](https://github.com/NVIDIA/OpenShell/discussions) - **Segnalazioni di bug e richieste di funzionalità:** [GitHub Issues](https://github.com/NVIDIA/OpenShell/issues), utilizzando i template delle issue - **Vulnerabilità di sicurezza:** segui [SECURITY.md](https://github.com/nvidia/openshell/blob/main/SECURITY.md). Non aprire una issue su GitHub. - **Roadmap:** [OpenShell Roadmap](https://github.com/orgs/NVIDIA/projects/233) e la [RFC board](https://github.com/orgs/NVIDIA/projects/233/views/6) - **Provalo nel cloud:** [Brev Launchable](https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg) OpenShell è costruito agent-first: viene sviluppato con gli stessi flussi di lavoro guidati dagli agenti che abilita. Consulta [CONTRIBUTING.md](https://github.com/nvidia/openshell/blob/main/CONTRIBUTING.md) per la configurazione dello sviluppo e il flusso di contribuzione, e [AGENTS.md](https://github.com/nvidia/openshell/blob/main/AGENTS.md) per le convenzioni di coding del repository. ## Telemetria OpenShell raccoglie telemetria anonima, limitata a categorie operative e conteggi, per contribuire a migliorare il progetto. Non raccoglie nomi di sandbox, hostname, percorsi di file, prompt, credenziali, nomi di provider o modelli, né contenuti degli utenti. Per disabilitarla, imposta `OPENSHELL_TELEMETRY_ENABLED=false` sul gateway, oppure `server.telemetryEnabled=false` per le installazioni Helm. Puoi anche escludere completamente la telemetria dalla compilazione. Consulta [Telemetry](https://docs.nvidia.com/openshell/latest/observability/telemetry) per i dettagli e i [community telemetry reports](https://github.com/nvidia/openshell/blob/main/telemetry/README.md) per le tendenze d'uso pubblicate. ## Avviso e disclaimer Questo software recupera, accede o interagisce automaticamente con materiali esterni. Tali materiali recuperati non sono distribuiti con questo software e sono disciplinati esclusivamente da termini, condizioni e licenze separati. Sei l'unico responsabile di trovare, esaminare e rispettare tutti i termini, le condizioni e le licenze applicabili, nonché di verificare la sicurezza, l'integrità e l'idoneità di qualsiasi materiale recuperato per il tuo specifico caso d'uso. Questo software è fornito "COSÌ COM'È", senza garanzie di alcun tipo. L'autore non rilascia dichiarazioni o garanzie riguardo a qualsiasi materiale recuperato e non si assume alcuna responsabilità per perdite, danni, responsabilità o conseguenze legali derivanti dall'uso o dall'impossibilità di usare questo software o qualsiasi materiale recuperato. Usa questo software e i materiali recuperati a tuo rischio. ## Licenza Questo progetto è concesso in licenza secondo la [Apache License 2.0](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE).
