OpenShell v0.1.6
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. Lea 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 sus datos, secretos o red. Usted declara 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 restringen 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 concedería, como alcanzar un nuevo host con credenciales o llamar a un nuevo método de API, de modo que esos cambios esperan a la revisión humana.
Consulte Architecture para saber cómo encajan el gateway, el supervisor y el sandbox.
Inicio rápido
Necesita Linux, macOS en Apple Silicon o Windows con WSL 2 (experimental), además de Docker, Podman o virtualización del host. Consulte 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.
Explorar más a fondo
- 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 solo funcionan en endpoints aprobados, incluida la inferencia.
- Gateways: el plano de control para sandboxes, políticas y acceso.
- Kubernetes: despliega la puerta de enlace con Helm. Tu CNI debe aplicar
NetworkPolicy. - Extensibilidad: middleware, interceptores y controladores de cómputo.
- Tutoriales: recorridos paso a paso sobre políticas y agentes.
- Compilaciones preliminares y de desarrollo: 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 el enrutamiento de inferencia. Se encuentran en skills/ y funcionan sin un checkout del código fuente de OpenShell.
SDKs
Los SDKs 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> | Instalación y uso |
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 en GitHub.
- Hoja de ruta: OpenShell Roadmap y el tablero de RFC
- 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 del desarrollo y el flujo de contribución, y AGENTS.md para las convenciones de código del repositorio.