OpenShell

[!IMPORTANT] Novo no OpenShell 0.1.x: uma cadência de lançamento 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.

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 lhes 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.

Como Funciona

O OpenShell governa o que os agentes podem fazer de duas maneiras: ele instrumenta o kernel para aplicar políticas em cada acesso a arquivo, 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.

• Aplicação em nível de kernel. Cada agente é executado em um sandbox isolado. Controles do kernel restringem quais arquivos ele pode acessar e quais chamadas de sistema pode fazer, e toda conexão de rede passa por uma verificação de política antes de sair do sandbox. Agentes nunca veem credenciais reais; o OpenShell as adiciona apenas a requisições destinadas a endpoints aprovados.
• Mudanças de política formalmente verificadas. Antes que uma mudança de política seja aprovada, o OpenShell usa verificação formal para sinalizar novos acessos arriscados que ela concederia, como alcançar um novo host com credenciais ou chamar um novo método de API, para que essas mudanças aguardem revisão humana.

Veja Arquitetura para entender como o gateway, o supervisor e o sandbox se encaixam.

Início Rápido

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 agente instalado. Para executar um agente real, siga Execute Seu Primeiro Agente: ele executa o OpenCode contra um modelo gratuito do OpenRouter e mostra como aprovar novos acessos conforme o agente precisar.

Explore Mais

• Sandboxes: imagens, runtimes, GPUs e ciclo de vida.
• Políticas: regras de sistema de arquivos, rede e processos, com o advisor e o prover para revisar mudanças.
• Providers: credenciais que funcionam apenas em endpoints aprovados, incluindo inferência.
• Gateways: o plano de controle para sandboxes, políticas e acesso.
• Kubernetes: implante o gateway com Helm. Seu CNI deve aplicar NetworkPolicy.
• Extensibilidade: middleware, interceptadores e drivers de computação.
• Tutoriais: passo a passo de políticas e agentes.
• Builds de pré-lançamento e desenvolvimento: experimente um lançamento futuro ou o commit mais recente em main.

Agent Skills

Instale as skills públicas do OpenShell para seu agente de codificaçã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.

SDKs

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/NVIDIA/OpenShell/sdk/go@latest	README
Rust	cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag>	Instalação e uso

Comunidade

• Perguntas e discussão: GitHub Discussions
• Relatórios de bugs e solicitações de recursos: GitHub Issues, usando os templates de issue
• Vulnerabilidades de segurança: siga o SECURITY.md. Não abra uma issue no GitHub.
• Roadmap: OpenShell Roadmap e o quadro de RFCs
• Experimente na nuvem: Brev Launchable

O OpenShell é construído com foco em agentes: ele é desenvolvido com os mesmos fluxos de trabalho orientados por agentes que possibilita. Veja CONTRIBUTING.md para configuração de desenvolvimento e o fluxo de contribuição, e AGENTS.md para as convenções de codificação do repositório.

Telemetria