Novita Agent Sandbox SDK for Python

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

📖 Documentation • 🔑 Get API Key

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

Installation

pip install novita-sandbox
pip install novita-sandbox[runtime]
pip install novita-sandbox[code-interpreter]
pip install novita-sandbox[desktop]
pip install novita-sandbox[all]

runtime is for users who only need Agent Runtime-related features; all includes every optional dependency.

Quick Start

Authentication

Get your Novita API key from the key management page.

Core Sandbox

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

import os
from novita_sandbox import Novita

novita = Novita(api_key=os.getenv("NOVITA_API_KEY", ""))

# Using the official template `base` by default
sandbox = novita.sandbox.create("base")

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

# Command execution
result = sandbox.commands.run('ls -la /tmp')
print(result.stdout)

sandbox.kill()

Code Interpreter

The Code Interpreter sandbox is available through the same client.

import os
from novita_sandbox import Novita

novita = Novita(api_key=os.getenv("NOVITA_API_KEY", ""))

sandbox = novita.code_interpreter.create()

# Execute Python code
result = sandbox.run_code('print("Hello, World!")')
print(result.logs)

sandbox.kill()

Desktop Automation

The Desktop sandbox is available through the same client.

import os
from novita_sandbox import Novita

novita = Novita(api_key=os.getenv("NOVITA_API_KEY", ""))

desktop = novita.desktop.create()

# Take a screenshot
screenshot = desktop.screenshot()

# Automate mouse and keyboard
desktop.left_click(100, 200)
desktop.press('Return')
desktop.write('Hello, World!')

desktop.kill()

Documentation

For comprehensive guides, API references, and examples, visit our official documentation.

Development

Install

poetry install --with dev --extras "all"

Test

make test
make test-core
make test-code-interpreter
make test-desktop

Metadata

Release files for novita-sandbox 2.1.1a2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for novita-sandbox 2.1.1a2
File	Size	Uploaded
novita_sandbox-2.1.1a2.tar.gz	530.6 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for novita-sandbox 2.1.1a2
File	Interpreter	ABI	Platform	Reset
novita_sandbox-2.1.1a2-py3-none-any.whl 661.3 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / novita_sandbox-2.1.1a2.tar.gz

Download URL	novita_sandbox-2.1.1a2.tar.gz
Size	530.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`d9acab90205e2729037320ca2bb5f18a7cd0f9c7b207f84082d39724197f31fe`
BLAKE2b-256 checksum How to use checksums	`2162d19dcd770d37a0e0f9e0d831d935ca9badb06ba0b176f2de29a7d82a571e`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.2 CPython/3.12.14 Linux/6.17.0-1022-azure`

Release files / novita_sandbox-2.1.1a2-py3-none-any.whl

Download URL	novita_sandbox-2.1.1a2-py3-none-any.whl
Size	661.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`35a66d3ee3c28e88233b8bbe14afb5f6fac9a007d20c76d3d717797be06c43d1`
BLAKE2b-256 checksum How to use checksums	`a9578ec624a0e5726b10cb67db029cce30a2de2d84618ca5f739866ca5d3dc9c`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.2 CPython/3.12.14 Linux/6.17.0-1022-azure`