nvidia/openshell

[! ВАЖНО] Новинка в OpenShell 0.1.x: стабильная частота выпуска, новые примитивы изоляции, расширенная поверхность расширения и новые API. Прочитайте руководство по обновлению 0.1.0.

OpenShell — это безопасное, приватное пространство выполнения для флотов автономных ИИ-агентов. Агенты наиболее полезны, когда они могут читать файлы, устанавливать пакеты, вызывать API и использовать учетные данные. OpenShell предоставляет им эту возможность без неограниченного доступа к вашим данным, секретам или сети. Вы указываете, что каждый агент может касаться в политике, и OpenShell это обеспечивает.

Как это работает

OpenShell регулирует, что агенты могут делать двумя способами: он инструментирует ядро для применения политики при каждом доступе к файлу, системном вызове и сетевом соединении во время выполнения, а также использует формальную верификацию для проверки, что позволит изменение политики перед её применением.

• Контроль на уровне ядра. Каждый агент работает в изолированной песочнице. Ядро контролирует ограничение, к какому файлу может получить доступ и какие системные вызовы может совершать, и каждое сетевое соединение проходит проверку политики перед выходом из песочницы. Агенты никогда не видят реальных учетных данных; OpenShell добавляет их только к запросам, предназначенным для одобренных конечных точек.

[!IMPORTANT] New in OpenShell 0.1.x: a stable release cadence, new isolation primitives, an expanded extension surface, and new APIs. Read the 0.1.0 upgrade guide.

OpenShell is the safe, private runtime for fleets of autonomous AI agents. Agents are most useful when they can read files, install packages, call APIs, and use credentials. OpenShell gives them that capability without giving them unrestricted access to your data, secrets, or network. You declare what each agent can touch in a policy, and OpenShell enforces it.

How It Works

OpenShell governs what agents can do in two ways: it instruments the kernel to enforce policy on every file access, system call, and network connection at runtime, and it uses formal verification to check what a policy change would allow before it is applied.

• Kernel-level enforcement. Each agent runs in an isolated sandbox. Kernel controls confine which files it can access and which system calls it can make, and every network connection passes through a policy check before it leaves the sandbox. Agents never see real credentials; OpenShell adds them only to requests bound for approved endpoints.
• Formally verified policy changes. Before a policy change is approved, OpenShell uses formal verification to flag risky new access it would grant, such as reaching a new host with credentials or calling a new API method, so those changes wait for human review.

See Architecture for how the gateway, supervisor, and sandbox fit together.

Quickstart

You need Linux, macOS on Apple Silicon, or Windows with WSL 2 (experimental), plus Docker, Podman, or host virtualization. See the Support Matrix for details.

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