Project Links

Meta

Author: Novita

Maintainer: Novita

Requires Python: >=3.9

Classifiers

Development Status

3 - Alpha

Intended Audience

Developers

License

OSI Approved :: MIT License

Operating System

OS Independent

Programming Language

Python :: 3
Python :: 3.9
Python :: 3.10
Python :: 3.11
Python :: 3.12

Topic

Scientific/Engineering :: Artificial Intelligence
Software Development :: Libraries :: Python Modules
System :: Operating System

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

Quick Start

Authentication

Get your Novita API key from the key management page.

Core Sandbox

The basic package provides a way to interact with the sandbox environment.

from novita_sandbox.core import Sandbox
import os

# Using the official template `base` by default
sandbox = Sandbox.create(
    template="base",
    api_key=os.getenv("NOVITA_API_KEY", "")
)

# 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 provides a Jupyter-like environment for executing code using the official code-interpreter-v1 template.

from novita_sandbox.code_interpreter import Sandbox
import os

sandbox = Sandbox.create(
    api_key=os.getenv("NOVITA_API_KEY", "")
)

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

sandbox.kill()

Desktop Automation

The Desktop sandbox allows you to control desktop environments programmatically using the official desktop template.

from novita_sandbox.desktop import Sandbox
import os

desktop = Sandbox.create(
    api_key=os.getenv("NOVITA_API_KEY", "")
)

# 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

Wheel compatibility matrix

Platform	Python 3
any

Files in release

novita_sandbox-2.0.8-py3-none-any.whl (599.6KiB)

novita_sandbox-2.0.8.tar.gz (476.1KiB)

Extras:

Dependencies:

attrs (>=23.2.0)

dockerfile-parse (<3.0.0,>=2.0.1)

httpcore (>=1.0.5)

httpx (<1.0.0,>=0.27.0)

packaging (>=24.1)

protobuf (>=5.26.1)

pydantic (<3.0.0,>=2.12.4)

python-dateutil (>=2.8.2)

rich (>=14.0.0)

typing-extensions (>=4.1.0)

wcmatch (<11.0,>=10.1)

novita-sandbox 2.0.8