# Legacy SDKs & CLI - 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-legacy-e2b-compatible

# Legacy SDKs & CLI

This legacy page is kept for users who still use the 1.x or beta SDK line. New SDK 2.x integrations should follow the current Sandbox documentation.

This page lists the legacy Novita Agent Sandbox SDK and CLI versions for users who still need the 1.x stable or 1.x beta SDK line.

##

[​](#legacy-novita-sdk-versions)

Legacy Novita SDK Versions

If you need to stay on the legacy 1.x SDK line, pin one of the following versions explicitly:

PackageLast 1.x stable versionLast 1.x beta versionPython SDK`novita-sandbox==1.0.5``novita-sandbox==1.2.5b2`JavaScript/TypeScript SDK`novita-sandbox@1.0.2``novita-sandbox@1.2.3b1`CLI`novita-sandbox-cli@1.0.4``novita-sandbox-cli@1.2.3b1`

##

[​](#installation)

Installation

###

[​](#install-legacy-stable-sdk)

Install Legacy Stable SDK

JavaScript & TypeScript

Python

```
npm i novita-sandbox@1.0.2
```

###

[​](#install-legacy-stable-cli)

Install Legacy Stable CLI

Bash

```
npm i -g novita-sandbox-cli@1.0.4
```

###

[​](#install-legacy-beta-sdk)

Install Legacy Beta SDK

JavaScript & TypeScript

Python

```
npm i novita-sandbox@1.2.3b1
```

###

[​](#install-legacy-beta-cli)

Install Legacy Beta CLI

Bash

```
npm i -g novita-sandbox-cli@1.2.3b1
```

##

[​](#setup-configuration)

Setup Configuration

Legacy SDK versions use `sandbox.novita.ai` by default. You only need to configure your Novita API key.

Bash

```
export NOVITA_API_KEY=""
```

##

[​](#examples)

Examples

Below is an example showing how to create a sandbox through the SDK and run specified commands.

JavaScript & TypeScript

Python

```
import { Sandbox } from 'novita-sandbox/code-interpreter'

const sbx = await Sandbox.create()
const execution = await sbx.commands.run('ls -l')
console.log(execution)

await sbx.kill()
```

Below is an example showing how to use the Novita Sandbox CLI.

Bash

```
# Authentication in CLI
novita-sandbox-cli auth login

# Start sandbox and connect to terminal
novita-sandbox-cli sandbox spawn

# List sandboxes
novita-sandbox-cli sandbox list

# Shutdown running sandboxes
novita-sandbox-cli sandbox kill
```

Last modified on June 5, 2026