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.
<!-- 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] > **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](https://docs.nvidia.com/openshell/latest/upgrade/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](https://docs.nvidia.com/openshell/latest/about/architecture) 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](https://docs.nvidia.com/openshell/latest/about/support-matrix) para detalhes. ```shell 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](https://docs.nvidia.com/openshell/latest/about/run-your-first-agent): ele executa o OpenCode contra um modelo gratuito do OpenRouter e mostra como aprovar novos acessos conforme o agente precisar. ## Explore Mais - [Sandboxes](https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview): imagens, runtimes, GPUs e ciclo de vida. - [Políticas](https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview): regras de sistema de arquivos, rede e processos, com o [advisor](https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) e o [prover](https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) para revisar mudanças. - [Providers](https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview): credenciais que funcionam apenas em endpoints aprovados, incluindo [inferência](https://docs.nvidia.com/openshell/latest/how-it-works/inference). - [Gateways](https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview): o plano de controle para sandboxes, políticas e acesso. - [Kubernetes](https://docs.nvidia.com/openshell/latest/kubernetes/setup): implante o gateway com Helm. Seu CNI deve aplicar `NetworkPolicy`. - [Extensibilidade](https://docs.nvidia.com/openshell/latest/extensibility/overview): middleware, interceptadores e drivers de computação. - [Tutoriais](https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy): passo a passo de políticas e agentes. - [Builds de pré-lançamento e desenvolvimento](https://docs.nvidia.com/openshell/latest/about/installation#prerelease-and-development-builds): 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: ```shell 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/`](https://github.com/nvidia/openshell/blob/main/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](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>` | [Instalação e uso](https://github.com/nvidia/openshell/blob/main/docs/sdk/rust.mdx) | ## Comunidade - **Perguntas e discussão:** [GitHub Discussions](https://github.com/NVIDIA/OpenShell/discussions) - **Relatórios de bugs e solicitações de recursos:** [GitHub Issues](https://github.com/NVIDIA/OpenShell/issues), usando os templates de issue - **Vulnerabilidades de segurança:** siga o [SECURITY.md](https://github.com/nvidia/openshell/blob/main/SECURITY.md). Não abra uma issue no GitHub. - **Roadmap:** [OpenShell Roadmap](https://github.com/orgs/NVIDIA/projects/233) e o [quadro de RFCs](https://github.com/orgs/NVIDIA/projects/233/views/6) - **Experimente na nuvem:** [Brev Launchable](https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg) O OpenShell é construído com foco em agentes: ele é desenvolvido com os mesmos fluxos de trabalho orientados por agentes que possibilita. Veja [CONTRIBUTING.md](https://github.com/nvidia/openshell/blob/main/CONTRIBUTING.md) para configuração de desenvolvimento e o fluxo de contribuição, e [AGENTS.md](https://github.com/nvidia/openshell/blob/main/AGENTS.md) para as convenções de codificação do repositório. ## Telemetria O OpenShell coleta telemetria anônima, limitada a categorias operacionais e contagens, para ajudar a melhorar o projeto. Ele não coleta nomes de sandbox, hostnames, caminhos de arquivos, prompts, credenciais, nomes de providers ou modelos, nem conteúdo do usuário. Para desativá-la, defina `OPENSHELL_TELEMETRY_ENABLED=false` no gateway, ou `server.telemetryEnabled=false` para instalações via Helm. Você também pode compilar a telemetria completamente fora. Veja [Telemetria](https://docs.nvidia.com/openshell/latest/observability/telemetry) para detalhes e os [relatórios de telemetria da comunidade](https://github.com/nvidia/openshell/blob/main/telemetry/README.md) para tendências de uso publicadas. ## Aviso e Isenção de Responsabilidade Este software recupera, acessa ou interage automaticamente com materiais externos. Esses materiais recuperados não são distribuídos com este software e são regidos exclusivamente por termos, condições e licenças separados. Você é o único responsável por encontrar, revisar e cumprir todos os termos, condições e licenças aplicáveis, e por verificar a segurança, integridade e adequação de quaisquer materiais recuperados para seu caso de uso específico. Este software é fornecido "COMO ESTÁ", sem garantia de qualquer tipo. O autor não faz representações ou garantias sobre quaisquer materiais recuperados, e não assume qualquer responsabilidade por perdas, danos, responsabilidades ou consequências legais decorrentes do seu uso ou incapacidade de usar este software ou quaisquer materiais recuperados. Use este software e os materiais recuperados por sua conta e risco. ## Licença Este projeto está licenciado sob a [Apache License 2.0](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE).
