Skip to content
Navigation

Isolated execution environments for safe agent operation.

Installation

Part of the exo-ai monorepo:

bash
git clone https://github.com/Midsphere-AI/exo-ai.git && cd exo-ai
uv sync

For Kubernetes support, install the extra from the packages/exo-sandbox directory:

bash
uv sync --extra kubernetes

Module path

python
import exo.sandbox

Package exports

ExportModuleDescription
Sandboxexo.sandbox.baseAbstract sandbox providing isolated execution
LocalSandboxexo.sandbox.baseSandbox that executes on the local machine
SandboxStatusexo.sandbox.baseLifecycle states for a sandbox
SandboxErrorexo.sandbox.baseError raised for sandbox-level errors
SandboxBuilderexo.sandbox.builderFluent builder for constructing sandbox instances
KubernetesSandboxexo.sandbox.kubernetesSandbox that manages a Kubernetes pod
FilesystemToolexo.sandbox.toolsSandboxed filesystem tool with directory restrictions
TerminalToolexo.sandbox.toolsSandboxed terminal tool with command filtering

Submodules