# Installation - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/guides/sandbox-agent-runtime-installation

# Installation

This feature is currently in beta. You need to install the beta versions of both the Novita Sandbox Python SDK and the CLI tool:

##

[​](#install-python-sdk-with-pip)

Install Python SDK with pip

Use the `--pre` flag to install the latest beta version:

```
pip install novita-sandbox==1.2.5b1
```

##

[​](#install-node-js-cli)

Install Node.js CLI

###

[​](#option-1-run-with-npx-recommended)

Option 1: Run with npx (Recommended)

Install the beta CLI locally in your project directory using `npm`, then run it with `npx`. This avoids polluting your global environment with the beta version.

```
# Install the latest beta version CLI
npm install novita-sandbox-cli@beta

# First, complete authentication
npx novita-sandbox-cli auth login

# Run agent configure command to configure your Agent
npx novita-sandbox-cli agent configure
```

###

[​](#option-2-global-installation)

Option 2: Global Installation

If you use the CLI frequently, you can install it globally:

```
# Install the latest beta version
npm install -g novita-sandbox-cli@beta
```

After installation, you can use the command directly:

```
novita-sandbox-cli agent configure
```

Last modified on May 15, 2026