Entorno de ejecución en sandbox para agentes de IA autónomos con políticas YAML declarativas que aplican restricciones de sistema de archivos, red y procesos, además de inyección de credenciales vinculadas al 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] > **Novedad en OpenShell 0.1.x:** una cadencia de versiones estable, nuevas primitivas de aislamiento, una superficie de extensión ampliada y nuevas API. [Lee la guía de actualización a 0.1.0](https://docs.nvidia.com/openshell/latest/upgrade/0-1-0). OpenShell es el entorno de ejecución seguro y privado para flotas de agentes de IA autónomos. Los agentes son más útiles cuando pueden leer archivos, instalar paquetes, llamar a API y usar credenciales. OpenShell les otorga esa capacidad sin darles acceso sin restricciones a tus datos, secretos o red. Tú declaras a qué puede acceder cada agente en una política, y OpenShell la aplica. ## Cómo funciona OpenShell gobierna lo que los agentes pueden hacer de dos maneras: instrumenta el kernel para aplicar la política en cada acceso a archivos, llamada al sistema y conexión de red en tiempo de ejecución, y utiliza verificación formal para comprobar qué permitiría un cambio de política antes de que se aplique. - **Aplicación a nivel de kernel.** Cada agente se ejecuta en un sandbox aislado. Los controles del kernel limitan a qué archivos puede acceder y qué llamadas al sistema puede realizar, y cada conexión de red pasa por una comprobación de política antes de salir del sandbox. Los agentes nunca ven credenciales reales; OpenShell las añade solo a las solicitudes destinadas a endpoints aprobados. - **Cambios de política verificados formalmente.** Antes de aprobar un cambio de política, OpenShell utiliza verificación formal para señalar el nuevo acceso riesgoso que otorgaría, como alcanzar un nuevo host con credenciales o llamar a un nuevo método de API, de modo que esos cambios esperan una revisión humana. Consulta [Architecture](https://docs.nvidia.com/openshell/latest/about/architecture) para saber cómo encajan el gateway, el supervisor y el sandbox. ## Inicio rápido Necesitas Linux, macOS en Apple Silicon o Windows con WSL 2 (experimental), además de Docker, Podman o virtualización de host. Consulta la [Support Matrix](https://docs.nvidia.com/openshell/latest/about/support-matrix) para más detalles. ```shell curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh openshell sandbox create --name demo ``` El instalador configura la CLI y un gateway local. La imagen de sandbox predeterminada es Ubuntu mínimo sin ningún agente instalado. Para ejecutar un agente real, sigue [Run Your First Agent](https://docs.nvidia.com/openshell/latest/about/run-your-first-agent): ejecuta OpenCode contra un modelo gratuito de OpenRouter y muestra cómo aprobar nuevo acceso a medida que el agente lo necesite. ## Explora más - [Sandboxes](https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview): imágenes, runtimes, GPUs y ciclo de vida. - [Policies](https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview): reglas de sistema de archivos, red y procesos, con el [advisor](https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) y el [prover](https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) para revisar cambios. - [Providers](https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview): credenciales que funcionan solo en endpoints aprobados, incluida la [inference](https://docs.nvidia.com/openshell/latest/how-it-works/inference). - [Gateways](https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview): el plano de control para sandboxes, políticas y acceso. - [Kubernetes](https://docs.nvidia.com/openshell/latest/kubernetes/setup): despliega el gateway con Helm. Tu CNI debe aplicar `NetworkPolicy`. - [Extensibility](https://docs.nvidia.com/openshell/latest/extensibility/overview): middleware, interceptores y controladores de cómputo. - [Tutorials](https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy): recorridos paso a paso de políticas y agentes. - [Prerelease and development builds](https://docs.nvidia.com/openshell/latest/about/installation#prerelease-and-development-builds): prueba una versión próxima o el último commit en `main`. ## Agent Skills Instala las skills públicas de OpenShell para tu agente de programación: ```shell npx skills add NVIDIA/OpenShell ``` Las skills enseñan a tu agente a manejar la CLI de OpenShell, escribir políticas de sandbox y depurar gateways y enrutamiento de inferencia. Se encuentran en [`skills/`](https://github.com/nvidia/openshell/blob/main/skills) y funcionan sin necesidad de una copia del código fuente de OpenShell. ## SDKs Los SDK conectan aplicaciones a un gateway de OpenShell. No instalan la CLI. Usa la misma versión de OpenShell para el SDK y el gateway cuando sea posible. | Lenguaje | Instalación | Documentación | |---|---|---| | 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) | ## Comunidad - **Preguntas y debate:** [GitHub Discussions](https://github.com/NVIDIA/OpenShell/discussions) - **Informes de errores y solicitudes de funciones:** [GitHub Issues](https://github.com/NVIDIA/OpenShell/issues), usando las plantillas de issues - **Vulnerabilidades de seguridad:** sigue [SECURITY.md](https://github.com/nvidia/openshell/blob/main/SECURITY.md). No abras un issue de GitHub. - **Hoja de ruta:** [OpenShell Roadmap](https://github.com/orgs/NVIDIA/projects/233) y el [RFC board](https://github.com/orgs/NVIDIA/projects/233/views/6) - **Pruébalo en la nube:** [Brev Launchable](https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg) OpenShell está construido con un enfoque agent-first: se desarrolla con los mismos flujos de trabajo impulsados por agentes que habilita. Consulta [CONTRIBUTING.md](https://github.com/nvidia/openshell/blob/main/CONTRIBUTING.md) para la configuración de desarrollo y el flujo de contribución, y [AGENTS.md](https://github.com/nvidia/openshell/blob/main/AGENTS.md) para las convenciones de código del repositorio. ## Telemetría OpenShell recopila telemetría anónima, limitada a categorías operativas y recuentos, para ayudar a mejorar el proyecto. No recopila nombres de sandbox, nombres de host, rutas de archivos, prompts, credenciales, nombres de proveedores o modelos, ni contenido del usuario. Para desactivarla, establece `OPENSHELL_TELEMETRY_ENABLED=false` en el gateway, o `server.telemetryEnabled=false` para instalaciones con Helm. También puedes compilar la telemetría fuera por completo. Consulta [Telemetry](https://docs.nvidia.com/openshell/latest/observability/telemetry) para más detalles y los [community telemetry reports](https://github.com/nvidia/openshell/blob/main/telemetry/README.md) para ver las tendencias de uso publicadas. ## Aviso y exención de responsabilidad Este software recupera, accede o interactúa automáticamente con materiales externos. Esos materiales recuperados no se distribuyen con este software y se rigen únicamente por términos, condiciones y licencias separados. Eres el único responsable de encontrar, revisar y cumplir todos los términos, condiciones y licencias aplicables, y de verificar la seguridad, integridad e idoneidad de cualquier material recuperado para tu caso de uso específico. Este software se proporciona "TAL CUAL", sin garantía de ningún tipo. El autor no ofrece ninguna declaración ni garantía con respecto a los materiales recuperados, y no asume ninguna responsabilidad por pérdidas, daños, responsabilidades o consecuencias legales derivadas de tu uso o incapacidad de uso de este software o de cualquier material recuperado. Usa este software y los materiales recuperados bajo tu propio riesgo. ## Licencia Este proyecto está licenciado bajo la [Apache License 2.0](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE).
