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
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file novita_sandbox-2.0.7a2.tar.gz.
File metadata
- Download URL: novita_sandbox-2.0.7a2.tar.gz
- Upload date:
- Size: 487.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.1.2 CPython/3.12.13 Linux/6.17.0-1018-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cf123dc9c3a12763d0b4b7207e2232566ff852856ca17f44d429e22d2fe81420
|
|
| MD5 |
f0d21eb8ae68ce80bc3dd01f20e7cdf5
|
|
| BLAKE2b-256 |
ad7434f53052119c83cd6f14b8b63c509a3752e5d4bdba1f80a69014b20ca0c9
|
File details
Details for the file novita_sandbox-2.0.7a2-py3-none-any.whl.
File metadata
- Download URL: novita_sandbox-2.0.7a2-py3-none-any.whl
- Upload date:
- Size: 625.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.1.2 CPython/3.12.13 Linux/6.17.0-1018-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3ed0c8c826b5cfa8d54e11241f990e1d7b766dc96106b77e086b90b3ac9ff870
|
|
| MD5 |
ffcca3c9c671fe4b588255b77189099a
|
|
| BLAKE2b-256 |
c50bec8c36cc7eee01cf6dd13f39e020d4a91420be92c0df6a4a2dc935116c8f
|
