Skip to content
Back to articles
open-source3 min

NVIDIA OpenShell: the open-source runtime that puts AI agents in a box with rules

KGA IT
2026-10-123 min
GitHubOpen SourceNVIDIAAI AgentsSecurity

What it is

NVIDIA's OpenShell bills itself as "the safe, private runtime for fleets of autonomous AI agents." Licensed under Apache 2.0, it has been among GitHub Trending's most popular projects over the past month and had more than 15,800 stars on October 12, 2026. The 0.1.x series, with a stable release cadence, new isolation primitives and new APIs, began on September 25; version 0.1.3 shipped on October 9.

The problem it tackles is familiar: agents are most useful when they can read files, install packages, call APIs and use credentials, but that makes them dangerous. An agent tricked by prompt injection, for example, can leak secrets or reach systems it shouldn't.

How it works

You declare in a policy what each agent can touch, and OpenShell enforces it in two ways:

  • Kernel-level enforcement: each agent runs in an isolated sandbox. Kernel controls limit which files it can access and which system calls it can make, and every network connection passes a policy check before leaving.
  • Invisible credentials: agents never see real credentials. OpenShell injects them only into requests bound for approved endpoints. If the agent tries to send the key elsewhere, it simply isn't there.
  • Formally verified policy changes: before a change is approved, OpenShell uses formal verification to flag risky new access (such as reaching a new host with credentials or calling a new API method), which then waits for human review.

Requirements and use

  • It runs on Linux, macOS on Apple Silicon or Windows with WSL 2 (experimental), with Docker, Podman or host virtualization.
  • The installer sets up the CLI and a local gateway; openshell sandbox create creates your first sandbox.
  • The official tutorial runs the open-source OpenCode agent with a free model via OpenRouter and shows how to approve new access as the agent needs it.
  • There's support for Kubernetes via Helm (your CNI must enforce NetworkPolicy), GPUs and extensions (middleware and interceptors).

Why it matters

In October, Anthropic reported unintended actions by Claude in evaluations, and the tensorlake npm worm stole AI tool configs. The message is the same: agents need technical limits, not just instructions. OpenShell is one of the first open layers from a major vendor focused on exactly that.

Limitations

  • The project is still at version 0.1.x; expect API changes.
  • Windows support is experimental.
  • Isolation reduces damage but doesn't replace permission reviews, logging and monitoring.

For businesses

  1. Run coding and automation agents inside sandboxes, never directly on a developer machine with every credential.
  2. Start with restrictive policies and grant access as needs appear.
  3. Require human approval for new hosts and credentials.

Sources


Want to put AI agents into production with isolation and access control? KGA IT offers a free consultation: kga-it.com.

Let's solve your technical challenges together.

KGA IT Solutions delivers AI, cloud, and DevOps expertise to address your specific challenges.

Contact Us