> This page is for version v0.1.1.
> For other versions, use one of these documentation indexes:
> - Latest (v0.1.4) (default): https://docs.nvidia.com/openshell/latest/llms.txt
> - Dev: https://docs.nvidia.com/openshell/dev/llms.txt
> - v0.1.4: https://docs.nvidia.com/openshell/v0.1.4/llms.txt
> - v0.1.3: https://docs.nvidia.com/openshell/v0.1.3/llms.txt
> - v0.1.2: https://docs.nvidia.com/openshell/v0.1.2/llms.txt
> - v0.1.1: https://docs.nvidia.com/openshell/v0.1.1/llms.txt
> - v0.1.0: https://docs.nvidia.com/openshell/v0.1.0/llms.txt
> - v0.0.116: https://docs.nvidia.com/openshell/v0.0.116/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/openshell/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/openshell/_mcp/server.

# NVIDIA OpenShell Developer Guide

> OpenShell is the safe, private runtime for fleets of autonomous AI agents. Run agents in sandboxed environments that protect your data, credentials, and infrastructure.

NVIDIA OpenShell is the safe, private runtime for fleets of autonomous AI agents. It provides sandboxed execution environments
that protect your data, credentials, and infrastructure. Agents run with exactly the permissions they need and
nothing more, governed by declarative policies that prevent unauthorized file access, data exfiltration, and
uncontrolled network activity.

> **Note**
>
> New in OpenShell 0.1.x: a [stable release cadence](/about/support-matrix#releases), new [isolation primitives](/about/architecture), and an expanded [extension surface](/extensibility/overview), along with much more.
>
> See our [upgrade guide](/upgrade/0-1-0) for everything that's changed.

## Get Started

Install OpenShell and create your first sandbox in two commands.

```shell
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create
```

Refer to [Run Your First Agent](/about/run-your-first-agent) for the complete image,
provider, and policy workflow.

---

## Explore

#### [About OpenShell](/about/overview)

Learn about OpenShell and its capabilities.

Concept

#### [Run Your First Agent](/about/run-your-first-agent)

Prepare an image, attach providers, and launch an agent in a sandbox.

Tutorial

#### [Tutorials](/tutorials)

Hands-on walkthroughs from first sandbox to custom policies.

Concept

#### [Gateways and Sandboxes](/how-it-works/gateways/overview)

Deploy gateways, create sandboxes, configure policies, providers, and workload images for your AI agents.

Concept

#### [Inference](/how-it-works/inference)

Attach model providers to selected sandboxes and call their native endpoints without exposing credentials.

Concept

#### [Observability](/observability)

Understand sandbox logs, access them with the CLI and TUI, and export OCSF JSON records.

How-To

#### [Policies](/how-it-works/policies/overview)

Define filesystem, process, and network controls for sandbox workloads.

Reference

#### [Security Best Practices](/security/best-practices)

Every configurable security control, its default, and the risk of changing it.

Concept

---

> **Notice and Disclaimer**
>
> This software automatically retrieves, accesses or interacts with external
> materials. Those retrieved materials are not distributed with this software
> and are governed solely by separate terms, conditions and licenses. You are
> solely responsible for finding, reviewing and complying with all applicable
> terms, conditions, and licenses, and for verifying the security, integrity and
> suitability of any retrieved materials for your specific use case. This
> software is provided "AS IS", without warranty of any kind. The author makes
> no representations or warranties regarding any retrieved materials, and
> assumes no liability for any losses, damages, liabilities or legal
> consequences from your use or inability to use this software or any retrieved
> materials. Use this software and the retrieved materials at your own risk.