OpenShell v0.1.5
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.
[!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.
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 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 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 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: 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: imágenes, runtimes, GPUs y ciclo de vida.
- Policies: reglas de sistema de archivos, red y procesos, con el advisor y el prover para revisar cambios.
- Providers: credenciales que funcionan solo en endpoints aprobados, incluida la inference.
- Gateways: el plano de control para sandboxes, políticas y acceso.
- Kubernetes: despliega el gateway con Helm. Tu CNI debe aplicar
NetworkPolicy. - Extensibility: middleware, interceptores y controladores de cómputo.
- Tutorials: recorridos paso a paso de políticas y agentes.
- 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:
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/ 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 |
| 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> | Installation and usage |
Comunidad
- Preguntas y debate: GitHub Discussions
- Informes de errores y solicitudes de funciones: GitHub Issues, usando las plantillas de issues
- Vulnerabilidades de seguridad: sigue SECURITY.md. No abras un issue de GitHub.
- Hoja de ruta: OpenShell Roadmap y el RFC board
- Pruébalo en la nube: Brev Launchable
OpenShell está construido con un enfoque agent-first: se desarrolla con los mismos flujos de trabajo impulsados por agentes que habilita. Consulta CONTRIBUTING.md para la configuración de desarrollo y el flujo de contribución, y AGENTS.md para las convenciones de código del repositorio.