# novita-sandbox

> Novita Sandbox SDK for JavaScript/TypeScript - A comprehensive SDK for code execution, desktop automation, and cloud computing environments

Latest version **2.1.1** (published 2026-09-08) · 0 weekly downloads

## Install

```sh
npm install novita-sandbox
pnpm add novita-sandbox
yarn add novita-sandbox
bun add novita-sandbox
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.1.1 |
| Published | 2026-09-08 |
| First published | 2025-09-03 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 10 |
| Unpacked size | 3.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Novita AI |
| Maintainers | novita_ai |
| Keywords | novita, novita-ai, ai-agent, sandbox, sdk, typescript, javascript |

## Links

- npm: https://www.npmjs.com/package/novita-sandbox
- Homepage: https://novita.ai/sandbox
- npm.io page: https://npm.io/package/novita-sandbox

## Dependencies (10)

- [tar](https://npm.io/package/tar.md) ^7.5.11
- [glob](https://npm.io/package/glob.md) ^11.1.0
- [chalk](https://npm.io/package/chalk.md) ^5.3.0
- [platform](https://npm.io/package/platform.md) ^1.3.6
- [openapi-fetch](https://npm.io/package/openapi-fetch.md) ^0.14.1
- [dockerfile-ast](https://npm.io/package/dockerfile-ast.md) ^0.7.1
- [compare-versions](https://npm.io/package/compare-versions.md) ^6.1.0
- [@bufbuild/protobuf](https://npm.io/package/@bufbuild/protobuf.md) ^2.6.2
- [@connectrpc/connect](https://npm.io/package/@connectrpc/connect.md) 2.0.0-rc.3
- [@connectrpc/connect-web](https://npm.io/package/@connectrpc/connect-web.md) 2.0.0-rc.3

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 2.1.1 (latest) — 2026-09-08
- 2.1.1-a5 (alpha) — 2026-10-22
- 1.2.3-b1 (beta) — 2026-04-02
- 2.1.1-a4 — 2026-10-08
- 2.1.1-a3 — 2026-09-22
- 2.1.1-a2 — 2026-09-22
- 2.1.1-a1 — 2026-09-10
- 2.1.0-a7 — 2026-09-07
- 2.1.0-a6 — 2026-09-07
- 2.1.0-a5 — 2026-09-01
- 2.1.0-a4 — 2026-08-31
- 2.1.0-a3 — 2026-08-27
- 2.1.0-a2 — 2026-08-27
- 1.2.6-a1 — 2026-08-14
- 2.1.0 — 2026-08-12
- … 42 more at https://npm.io/package/novita-sandbox/versions

## README

# Novita Agent Sandbox JS SDK

A TypeScript/JavaScript SDK for Novita Agent Sandbox environments that provides code execution, desktop automation, and cloud computing capabilities..

## Table of Contents

- [Novita Agent Sandbox JS SDK](#novita-agent-sandbox-js-sdk)
  - [Table of Contents](#table-of-contents)
  - [Installation](#installation)
  - [Features](#features)
  - [Authentication](#authentication)
  - [Usage](#usage)
    - [Core Sandbox](#core-sandbox)
    - [Code Interpreter](#code-interpreter)
    - [Desktop Automation](#desktop-automation)
  - [Documentation](#documentation)

## Installation

```bash
npm install novita-sandbox
```

## Features

- **Code Interpreter**: Execute Python, JavaScript, and other languages in isolated environments
- **Desktop Automation**: Control desktop applications and GUI interactions
- **Cloud Computing**: Scalable sandbox environments for various computing tasks
- **Data Visualization**: Built-in charting and visualization capabilities
- **File System Operations**: Complete file system management and monitoring

## Authentication

Get your Novita API key from [here](https://novita.ai/settings/key-management).

## Usage

### Core Sandbox

Use the high-level `Novita` client to share one set of credentials across namespaces.

```typescript
import { Novita } from 'novita-sandbox';

const novita = new Novita({
  apiKey: process.env.NOVITA_API_KEY || '',
});

// Using the official template `base` by default.
const sandbox = await novita.sandbox.create('base');

// File operations
await sandbox.files.write('/tmp/test.txt', 'Hello, World!');
const content = await sandbox.files.read('/tmp/test.txt');

// Command execution
const result = await sandbox.commands.run('ls -la /tmp');
console.log(result.stdout);

// Real-time monitoring
sandbox.files.watchDir('/tmp', (event) => {
  console.log(`File ${event.name} was ${event.type}`);
});
```

### Code Interpreter

The Code Interpreter sandbox is available through the same client.

```typescript
import { Novita } from 'novita-sandbox';

const novita = new Novita({
  apiKey: process.env.NOVITA_API_KEY || '',
});

const sandbox = await novita.codeInterpreter.create();

// Execute Python code
const result = await sandbox.runCode('print("Hello, World!")');
console.log(result.logs);
```

### Desktop Automation

The Desktop sandbox is available through the same client.

```typescript
import { Novita } from 'novita-sandbox';

const novita = new Novita({
  apiKey: process.env.NOVITA_API_KEY || '',
});

const desktop = await novita.desktop.create();

// Take a screenshot
const screenshot = await desktop.screenshot();

// Automate mouse and keyboard
await desktop.leftClick(100, 200);
await desktop.press('Enter');
await desktop.write('Hello, World!');
```

## Documentation

For comprehensive guides and API reference, visit the [official documentation](https://novita.ai/docs/guides/sandbox-overview).

---
_Source: https://npm.io/package/novita-sandbox · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._