whatisgithub

What is openshell?

nvidia/openshell — explained in plain English

Analysis updated 2026-06-26

5,898RustAudience · ops devopsComplexity · 4/5Setup · moderate

In one sentence

An NVIDIA tool that runs AI agents inside isolated containers with fine-grained YAML policies controlling which websites and file paths the agent can access, preventing data leaks and unauthorized actions.

Mindmap

mindmap
  root((OpenShell))
    What it does
      Sandboxed AI agents
      Network policy control
      Credential anonymization
    Policies
      YAML files
      Website allowlists
      File path rules
    Container Backends
      Docker
      Podman
      Kubernetes
      Virtual machines
    Status
      Alpha single-player
      Multi-tenant roadmap
    Use Cases
      Safe code execution
      Privacy-aware routing
      Agent deployment
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run an AI coding agent inside a sandbox that can only reach pre-approved websites and file paths

USE CASE 2

Define network access policies in YAML and enforce them without restarting the agent container

USE CASE 3

Intercept and anonymize AI model API calls to prevent credential leaks to external services

USE CASE 4

Deploy isolated AI agent environments on Kubernetes for team-wide controlled execution

What is it built with?

RustDockerPodmanKubernetesYAML

How does it compare?

nvidia/openshellflamegraph-rs/flamegraphalexpasmantier/television
Stars5,8985,9205,872
LanguageRustRustRust
Setup difficultymoderatemoderateeasy
Complexity4/52/51/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Currently alpha with known rough edges, requires Docker, Podman, or a VM backend to be installed first.

So what is it?

OpenShell is a tool from NVIDIA that runs AI agents inside isolated, controlled environments called sandboxes. The core problem it addresses is that AI agents often need to execute code, browse the internet, and access files, but letting them do all of that freely is risky. OpenShell wraps each agent session in a container and enforces policies that specify exactly what the agent is and is not allowed to do, blocking unauthorized file access, unwanted network connections, and data leaks. The policies are written as short YAML files that describe which websites can be reached, which HTTP methods are allowed, and which local paths the agent can touch. These rules are enforced by a proxy that sits between the agent and the outside world. If the agent tries to make a network request that is not covered by the policy, the request is blocked and logged. You can apply new policies without restarting the sandbox. Setting up a sandbox is a single command. You name which AI agent you want to run, and OpenShell starts a container that includes common developer tools such as Python, Node.js, git, and network utilities. Supported container backends include Docker, Podman, and lightweight virtual machines. There is also an experimental path for deploying on Kubernetes. The project also includes a privacy-aware routing layer that can intercept calls to AI model APIs, strip the caller's credentials, and inject its own, keeping sensitive context away from external services. OpenShell is currently in alpha, described by the team as single-player mode: one developer, one environment, one gateway. Multi-tenant enterprise deployments are on the roadmap but not yet available. The README is honest about rough edges.

Copy-paste prompts

Prompt 1
Using OpenShell, write a YAML policy file that allows an AI agent to access only github.com and pypi.org and blocks all other network requests.
Prompt 2
Show me the single command to start an OpenShell sandbox with Docker for a Python coding agent and how to apply a new policy without restarting.
Prompt 3
Help me set up OpenShell to intercept and anonymize all outbound calls to an OpenAI-compatible API endpoint.
Prompt 4
Configure an OpenShell Kubernetes deployment so each team member gets their own isolated agent sandbox with separate YAML policies.

Frequently asked questions

What is openshell?

An NVIDIA tool that runs AI agents inside isolated containers with fine-grained YAML policies controlling which websites and file paths the agent can access, preventing data leaks and unauthorized actions.

What language is openshell written in?

Mainly Rust. The stack also includes Rust, Docker, Podman.

How hard is openshell to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is openshell for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.