Runtime em sandbox para agentes de IA autônomos com políticas YAML declarativas que impõem restrições de filesystem, rede e processos, além de injeção de credenciais vinculada ao endpoint.
[!NOTE] 🚧 O OpenShell agora faz parte da CNCF! Estamos no processo de mover o desenvolvimento para ai-openshell e a governança para a CNCF. Até que a migração seja concluída, continue usando o repositório NVIDIA/OpenShell para código, issues e pull requests.
[!IMPORTANT] Novo no OpenShell 0.1.x: uma cadência de lançamentos estável, novas primitivas de isolamento, uma superfície de extensão ampliada e novas APIs. Leia o guia de atualização para 0.1.0.
O OpenShell é o runtime seguro e privado para frotas de agentes de IA autônomos. Agentes são mais úteis quando podem ler arquivos, instalar pacotes, chamar APIs e usar credenciais. O OpenShell lhes dá essa capacidade sem conceder acesso irrestrito aos seus dados, segredos ou rede. Você declara o que cada agente pode acessar em uma política, e o OpenShell a aplica.
O OpenShell controla o que os agentes podem fazer de duas maneiras: ele instrumenta o kernel para aplicar a política em cada acesso a arquivos, chamada de sistema e conexão de rede em tempo de execução, e usa verificação formal para checar o que uma mudança de política permitiria antes de ser aplicada.
Consulte Arquitetura para saber como o gateway, o supervisor e o sandbox se integram.
Você precisa de Linux, macOS em Apple Silicon ou Windows com WSL 2 (experimental), além de Docker, Podman ou virtualização de host. Consulte a Matriz de Suporte para detalhes.
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
O instalador configura a CLI e um gateway local. A imagem de sandbox padrão é um Ubuntu mínimo sem nenhum agente instalado. Para executar um agente real, siga Run Your First Agent: ele executa o OpenCode com um modelo gratuito do OpenRouter e mostra como aprovar novo acesso conforme o agente precisar.
Para suporte nativo ao Windows através do Microsoft MXC, consulte o guia de compilação e execução no Windows para configuração e limitações atuais.
NetworkPolicy.main.Instale as skills públicas do OpenShell para o seu agente de programação:
npx skills add NVIDIA/OpenShell
As skills ensinam seu agente a operar a CLI do OpenShell, escrever políticas de sandbox e depurar gateways e roteamento de inferência. Elas ficam em skills/ e funcionam sem um checkout do código-fonte do OpenShell.
Os SDKs conectam aplicações a um gateway OpenShell. Eles não instalam a CLI. Use a mesma versão do OpenShell para o SDK e o gateway quando possível.
| Linguagem | Instalação | Documentação |
|---|---|---|
| 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> | Instalação e uso |
O OpenShell é construído com foco em agentes: ele é desenvolvido com os mesmos fluxos de trabalho orientados por agentes que possibilita. Consulte o CONTRIBUTING.md para configuração de desenvolvimento e o fluxo de contribuição, e o AGENTS.md para as convenções de código do repositório.