Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

novita_sandbox-2.1.0a1.tar.gz (495.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

novita_sandbox-2.1.0a1-py3-none-any.whl (623.3 kB view details)

Uploaded Python 3

File details

Details for the file novita_sandbox-2.1.0a1.tar.gz.

File metadata

  • Download URL: novita_sandbox-2.1.0a1.tar.gz
  • Upload date:
  • Size: 495.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.12.13 Linux/6.17.0-1020-azure

File hashes

Hashes for novita_sandbox-2.1.0a1.tar.gz
Algorithm Hash digest
SHA256 96ac62d960173e1d3b8a03888e6e2ac0321ba03d3bd1656a65e612531cb02c8f
MD5 34444a366c27e775cb333fad3f15dff4
BLAKE2b-256 352f394cda89294df0a445f350efd5478ab7fec31303ff56b59721ee5306b91a

See more details on using hashes here.

File details

Details for the file novita_sandbox-2.1.0a1-py3-none-any.whl.

File metadata

  • Download URL: novita_sandbox-2.1.0a1-py3-none-any.whl
  • Upload date:
  • Size: 623.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.12.13 Linux/6.17.0-1020-azure

File hashes

Hashes for novita_sandbox-2.1.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 9c7c594b54750dbefbab9dd43508bb87eb9b2de7fad8c02337c48ec6ddcb5ce3
MD5 1aa49fb1a1e094cb261af7a427c03172
BLAKE2b-256 12744cca823f45f1698b03b60b05ed94428e8fd74fd8591918aa2263f865157b

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page