# What Is NVIDIA OpenShell? A Runtime for AI Agents

By Osei Tetteh · 2026-10-23 · Source: https://www.activepieces.com/blog/what-is-nvidia-openshell-a-runtime-for-ai-agents

---
<aside class="tldr"><p class="tldr-label">Summary</p><p>NVIDIA OpenShell is a runtime that executes AI agents inside an enforced sandbox, controlling their access to files, networks and tools through gated policies.</p><ul><li>Only 1% of large organisations run agents in production on live business data.</li><li>Only 14.4% of organisations send agents live with full security approval.</li></ul></aside>

## OpenShell is NVIDIA's runtime for sandboxed AI agents

### The short answer

OpenShell is a runtime from NVIDIA that runs an AI agent inside an enforced boundary, so the agent reaches files, network and tools only through a gate you control, much as a workflow tool like [Activepieces](https://www.activepieces.com) routes automation steps through defined connections rather than open access.

![Activepieces workflow builder with HTTP request step selected and its settings panel open showing method, URL, headers, and…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/9e36e973-de4a-435f-8912-12e666216b2d/self-host-mistral-ai-enterprise-deployment-guide-3f7fe28d.webp)

Plenty of teams already run agents unsanctioned, on a laptop with the developer's full permissions or wired into workflows with whatever credentials were to hand.

**OpenShell treats least privilege as a design problem**: the boundary is built into the runtime, not left as a policy line.

Look at the diagram: the agent sits inside the border, and every path to files, network and tools passes through one gate. Take from it that the agent never holds access of its own, only what the gate grants.

Once the gate exists, everything past it is a decision you now have to make deliberately, and that's the tradeoff the rest of this article weighs.

To find the project, go to NVIDIA's own GitHub organisation, at [NVIDIA/OpenShell](https://github.com/NVIDIA/OpenShell). The repository lists [517 branches](https://github.com/NVIDIA/OpenShell/branches) and [159 tags](https://github.com/NVIDIA/OpenShell/tags), which means the project is moving quickly and versions change often, so pin the version you test.

I won't give a release date here, because I can't state one from the maker's pages; treat OpenShell as new.

### What 'OpenShell agents' means as a search phrase

Search for "OpenShell agents" and you won't find a separate product. It means agents that run inside OpenShell, whatever model or framework drives them.

**Only 1% of large organisations run agents** in production on live business data, according to [Sirocco Group, citing a Cisco survey](https://www.siroccogroup.com/ai-agents-the-85-5-production-gap/), which means **agents aren't yet trusted for business-critical operations**. That is the gap between experiments and live use, and it's the reason to care.

Most are holding back, and the likely cause is trust in what an agent might do. A runtime that enforces boundaries targets exactly that hesitation.

## What OpenShell does to contain an agent

To contain an agent, OpenShell runs it in an isolated sandbox and enforces policy on which files and network destinations it can reach, rather than trusting the agent to behave.

That matters because [Gravitee](https://www.gravitee.io/blog/state-of-ai-agent-security-2026-report-when-adoption-outpaces-control) found only 14.4% of organisations send agents live with full security approval. In **the other 85.6%**, someone shipped on partial sign-off or on trust, so a boundary the runtime enforces replaces a promise nobody verified.

![How often AI agents launch with full security sign-off](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/31b4cb32-8c4a-409f-b60b-fb1d8cb13b93/what-is-nvidia-openshell-a-runtime-for-ai-agents-0257bda4.svg "Source: Gravitee (2026)")

Put the agent inside a sandbox, separated from the host it would otherwise share, and the design problem becomes least privilege: start from nothing and grant only what the task needs.

Whether that's the right default for your workload depends on how much the agent must touch, and that's a tradeoff to test, not assume.

In NVIDIA's README and docs, four kinds of control appear:

- Isolation of the agent process from the host
- Policy enforcement, so rules hold regardless of what the agent decides
- File access limits on what the agent can read or write
- Network access limits on where the agent can connect

Read the four together. File and network limits are the ones that decide whether a misbehaving agent can leak data or damage something, and policy enforcement is what keeps those limits from being optional.

I've kept to those four categories because I'm not describing mechanisms or behaviours the documentation doesn't spell out.

Performance overhead, how policies are written at scale and how it compares with other sandboxes are all unanswered here. Treat each as something to test in your own environment before you rely on it.

## How to get OpenShell and what it costs

You get OpenShell from NVIDIA's public repository under an open-source licence, and the maker lists no price beyond that licence, so the real cost is the time you spend adopting it.

### OpenShell installation steps and system requirements

On laptops and shared servers, agents already run with whatever access the developer happens to hold. Moving them into a sanctioned runtime only works if the route in is short.

The table shows where each fact comes from, so you can check the maker's wording instead of trusting mine.

| Item | What the repository or NVIDIA page states | Source |
|---|---|---|
| Install route | Set out in the repository README | Repository README |
| Requirements | Listed in the README and project docs | Repository README and docs |
| Licence | Open-source, as declared in the repository | Repository licence file |
| Price | None beyond the licence | Repository and NVIDIA's OpenShell page |
| Release date | Shown in the repository's release history | Repository releases |

_Prices and plan limits checked against [github.com](https://github.com/NVIDIA/OpenShell) and [docs.claude.com](https://docs.claude.com/en/docs/about-claude/models/overview) and [claude.com](https://claude.com/pricing) and [openai.com](https://openai.com/chatgpt/pricing) and [gemini.google](https://gemini.google/subscriptions) on October 23, 2026._

Read the requirements row against your actual hosts before anything else. A runtime that enforces boundaries will be sensitive to the kernel, container setup and permissions of the machine under it.

Because the licence is open-source, you can read the code that enforces the boundary. For a tool whose whole job is restraint, that's worth more than a feature list.

Read the licence file itself for your legal team's terms. I haven't found a paid tier, so treat the price as the licence and nothing more.

Where NVIDIA puts no figure on compute, hosting or engineering time, I won't invent one. Each of these is a real line item you must estimate yourself:

- the hosts that run the sandboxes
- the time to write and tune policies for each agent
- the maintenance as a young project changes between releases

## Where OpenShell is strong and weak so far

What you get is containment; what it costs is a new runtime your team must adopt, learn and operate. We haven't run it, so this verdict rests on NVIDIA's own claims and what its public project shows.

### OpenShell strengths according to NVIDIA

The way a platform lead would put it, least privilege for an agent is a design problem, not a policy line, and that's how NVIDIA frames it. Telling an agent to behave is a request. Enforcing what it can reach is a boundary.

That's the pitch, and it's the right one for teams whose agents already run unsanctioned on laptops with broad credentials.

<blockquote class="pull"><p>Telling an agent to behave is a request. Enforcing what it can reach is a boundary.</p></blockquote>

You give up some agent freedom and get a boundary you can defend to a skeptical security review. That is the explicit tradeoff.

### OpenShell gaps in the repository and docs

**Young is the word for this project**, and it shows in what's missing. The documentation is the maker's own account of its behavior. We found no independent write-ups, no third-party audits and no production reports we could cite.

Claims about how well the boundaries hold are therefore unverified. Anything you read comparing OpenShell with other sandboxing approaches is premature, because the evidence for a fair comparison doesn't exist yet.

Expect interfaces and defaults to shift as the project matures.

### Who should wait before adopting OpenShell

**Wait if your agents touch nothing sensitive**, because the adoption cost buys you little. Wait if you need a vendor-neutral track record before approving a runtime, or if your team can't absorb another piece of infrastructure to learn.

Teams that fear what an agent might do should pilot it now on a low-stakes workload and judge it against NVIDIA's documentation, not against comparisons it hasn't yet earned.

## OpenShell compared with established agent sandboxing options

Against the usual alternatives, OpenShell's pitch is policy enforced around the agent, and its weak point is track record, so judge it on NVIDIA's docs rather than on rankings.

### Comparison table

Read the maturity column first: it's the one where OpenShell has the least to show. The table below sets the four options side by side, with cells dated 2026-10-23.

| Option | Isolation method | Policy control | Maturity | Price | Setup effort |
|---|---|---|---|---|---|
| OpenShell | Enforced boundary, per NVIDIA's docs | Policy set by you, enforced by the runtime | New project | Source on GitHub; see NVIDIA's docs | Runtime to adopt and policies to write |
| Containers or VMs | Shared kernel (containers) or hypervisor (VMs) | Whatever you build | Long-established | Your own infrastructure | You assemble and maintain it |
| Hosted sandboxes such as E2B | Remote sandbox run by the vendor | Vendor's settings | Commercial service | Usage-based; see vendor page | Low: API key and SDK |
| No sandbox | None | None | Not applicable | Free | None |

Treat stars as attention, not quality. On [GitHub](https://github.com/NVIDIA/OpenShell), gVisor has 19,755 stars and E2B 14,517.

![Three columns of different heights topped with stars](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/7abc9b40-1832-4f23-bfee-bde36dd347be/what-is-nvidia-openshell-a-runtime-for-ai-agents-be05d835.webp)

With containers and VMs you get control, and the cost is that least privilege becomes your design problem. You write the network rules and the filesystem limits, and you keep them current.

Trade control for speed and you get hosted services. You get a remote sandbox in minutes, but your agent's work runs on someone else's infrastructure.

In practice, many teams already run agents with no boundary at all, on a laptop with real credentials. That's the baseline OpenShell has to beat.

## Connect OpenShell to a workflow in Activepieces

As of 2026-10-23, Activepieces has no OpenShell integration, and we haven't run OpenShell, so any connection is one you assemble from general-purpose steps and test yourself.

Whether or not anyone sanctions it, teams will wire an agent into a workflow, so the useful question is which route gives you the least to trust. Go in this order, simplest first:

1. Confirm in NVIDIA's OpenShell documentation what it exposes: an HTTP endpoint, an OpenAI-compatible API, an MCP server, or none of these.
2. Try an HTTP request step.
3. Try an AI step with a custom provider.
4. Try an MCP server.

![Checklist of four steps beside a server with an endpoint socket](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/13576536-7d63-4e74-84d9-2f1db67637d3/what-is-nvidia-openshell-a-runtime-for-ai-agents-dc6e3dc4.webp)

If step one doesn't describe the matching interface, that route doesn't exist. Skip any that the docs don't describe.

If OpenShell offers an HTTP interface, this is the lowest-commitment test. Call it from a plain HTTP request step with whatever authentication the docs specify.

A sandbox gives an agent a boundary, but not a role or an audit trail, and those belong to the platform around it.

Activepieces treats agents as actors too: custom RBAC and control over which apps a team may connect limit what an agent can reach, and each agent gets least privilege of its own.

![AI Agent Development: What It Takes to Build Agentic Systems](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/036e8332-042b-431c-916f-17ebc1684dbb/building-your-first-wix-chat-automation-without-3bc3c7d3.webp)

In the run detail view, every tool call in an agent step is listed separately with its own input and output, and the enterprise RBAC docs are where you confirm that access policies cover agents.

If the docs say OpenShell serves an OpenAI-compatible API, point an AI step at it as a custom provider. The workflow then treats the sandboxed agent like any other model.

The tradeoff is that you inherit only the chat-style interface. Whether tool calls and sandbox policy decisions surface through it is something to verify, not assume.

If OpenShell exposes an MCP server, connect it last. It offers the richest interaction, since the workflow can call the agent's tools directly.

It also gives the agent the most reach, so scope what it can touch before you connect it, and treat that scoping as part of the design.

## What to do about OpenShell this week

Run a small, dated evaluation before anything else: five steps, none of which touch production, and each one answers a question you'd otherwise settle by assumption, so assumptions don't become surprises in production.

1. Read the README and the licence. They tell you what the maker claims and what you may do with it.
2. Check the release date and recent activity. A young project can change under you, so see how often it ships.
3. List the agents you run and what each can touch. Least privilege for an agent is a design problem: you can't scope reach you haven't inventoried.
4. Try a throwaway task with no production credentials. Give it a dummy repository and a scratch token, and see whether the boundary holds.
5. Re-check the maker's pages. Everything here is dated 2026-10-23 and may already have moved.

What you're testing is whether the agent stays inside the boundary the docs describe. Many teams already let agents run on a developer laptop with that developer's own keys, because it's faster than waiting for approval.

![A laptop on a desk with a huge ring of keys plugged into its side, while a large heavy gate with a padlock stands unused in…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/48fdb4b3-b965-4393-b80f-b44eba66558c/what-is-nvidia-openshell-a-runtime-for-ai-agents-ec9bfd38.webp)

A sandbox is the sanctioned alternative, and step four is where you learn whether it's also tolerable to work in.

Read the policy section against your step-three inventory. For each agent, ask whether the documented controls can express the narrow access you listed, or only a coarse allow-or-deny.

Where policy is coarse, you trade safety for convenience, and you should know which side you're on before rollout.

Expect gaps. A young runtime will have behaviours the maker hasn't documented, and comparisons with other tools haven't been earned yet.

Write down each gap as an open question, and don't fill it with a guess. Then re-check the pages: a gap that closes in the docs is evidence, and a gap that stays open is a reason to keep the pilot small.

## Frequently asked questions

Re-checking the docs won't settle everything, so here are four questions the body leaves open, answered as far as the evidence goes.

The licence is Apache 2.0, and the maker lists no price, so read the license in NVIDIA's own repository before you budget.

Whatever it says, the runtime is only part of the bill: the compute it runs on and the engineering time to write policies are separate costs.

Because the runtime's job is to put a boundary around an agent process, the agent's maker probably matters less than how it runs.

But compatibility with a specific agent is a claim for NVIDIA's documentation to make, and we haven't tested one ourselves. If your agent isn't on a documented list, treat it as an experiment.

### Is OpenShell safe enough for production?

Not on its own record yet. It's young, and its enforcement hasn't been tested by years of other people's incidents.

**Run it on a bounded pilot where a failed boundary costs you little, and widen scope only as the documented gaps close.** That's a tradeoff, and for a team worried about what an agent might do, a boundary you can inspect still beats no boundary.

That question has its own section in this article, where the specifics belong. Nothing here should be read as an answer to it.

## Related reading

- [NVIDIA Switchyard: Routing AI Agent Calls Across Models](https://www.activepieces.com/blog/nvidia-switchyard-routing-ai-agent-calls-across-models)

## References

- [GitHub](https://github.com/NVIDIA/OpenShell)
- [Gravitee](https://www.gravitee.io/blog/state-of-ai-agent-security-2026-report-when-adoption-outpaces-control)
- [Sirocco Group (citing Cisco survey)](https://www.siroccogroup.com/ai-agents-the-85-5-production-gap/)
