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.
[!NOTE] 🚧 ¡OpenShell ahora forma parte de la CNCF! Estamos en proceso de trasladar el desarrollo a ai-openshell y la gobernanza a la CNCF. Hasta que se complete el traslado, sigue utilizando el repositorio NVIDIA/OpenShell para el código, los issues y las pull requests.
[!IMPORTANT] Novedades 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.
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 brinda esa capacidad sin darles acceso sin restricciones a tus datos, secretos o red. Declaras a qué puede acceder cada agente en una política, y OpenShell la aplica.
OpenShell controla 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 aplicarlo.
Consulta Architecture para ver cómo encajan el gateway, el supervisor y el sandbox.
Necesitas Linux, macOS en Apple Silicon, o Windows con WSL 2 (experimental), además de Docker, Podman o virtualización del host. Consulta la Support Matrix para más detalles.
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
El instalador configura la CLI y una puerta de enlace 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: ejecuta OpenCode contra un modelo gratuito de OpenRouter y muestra cómo aprobar nuevo acceso a medida que el agente lo necesite.
Para compatibilidad nativa con Windows a través de Microsoft MXC, consulta la guía de compilación y ejecución en Windows para la configuración y las limitaciones actuales.
NetworkPolicy.main.Instala las skills públicas de OpenShell para tu agente de programación:
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 el enrutamiento de inferencia. Se encuentran en skills/ y funcionan sin necesidad de un checkout del código fuente de OpenShell.
Los SDKs conectan aplicaciones a un gateway de OpenShell. No instalan la CLI. Cuando sea posible, usa la misma versión de OpenShell para el SDK y el gateway.
| Lenguaje | Instalación | Documentación |
|---|---|---|
| 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> | Instalación y uso |