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
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.1a6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| novita_sandbox-2.1.1a6.tar.gz | 575.3 kB | Without provenance | Details for novita_sandbox-2.1.1a6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| novita_sandbox-2.1.1a6-py3-none-any.whl | Python 3 | none | any | Details for novita_sandbox-2.1.1a6-py3-none-any.whl |
Total release size: 1.3 MB
Release files / novita_sandbox-2.1.1a6.tar.gz
| Download URL | novita_sandbox-2.1.1a6.tar.gz |
|---|---|
| Size | 575.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
99f040a6e4ccfdfade9ff0bb1b52b48adc41f90916839a490ae555e016552440
|
|
BLAKE2b-256 checksum How to use checksums |
9f6804e6dcb26c39ba04c06b168f393e5492ffa78b14edf9ee6fe07b89782696
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.2 CPython/3.12.15 Linux/6.17.0-1022-azure
|
Release files / novita_sandbox-2.1.1a6-py3-none-any.whl
| Download URL | novita_sandbox-2.1.1a6-py3-none-any.whl |
|---|---|
| Size | 698.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dbefa7b6e752bb9ccadb09377534c7da94ba5d110ca58942829c64ccfb1cdaeb
|
|
BLAKE2b-256 checksum How to use checksums |
fd32b1153764ea61e2474d298cc9aa48ef7c88ca7a2f0e350239852ccf391916
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.2 CPython/3.12.15 Linux/6.17.0-1022-azure
|
Security for novita-sandbox 2.1.1a6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.