Novita Sandbox

Run agent code in Novita cloud sandboxes with a single config line

Novita is a cloud sandbox backend that runs your agent’s code in an isolated remote environment — no local Docker, no host access.

Quick Start

1. Install and set your key

   pip install "praisonai-sandbox[novita]"
   export NOVITA_API_KEY="your-api-key"

2. Run an agent in a Novita sandbox

   from praisonaiagents import Agent, SandboxConfig
   
   agent = Agent(
       name="Coder",
       instructions="Run code safely",
       sandbox=SandboxConfig.novita(),
   )
   agent.start("Print the current directory tree")

The user asks the agent to run code; the agent hands it to a Novita cloud sandbox, which executes it in isolation and returns the result.

How It Works

Each run starts a fresh Novita sandbox, executes the code, and cleans up.

NovitaSandbox implements the standard SandboxProtocol — start, stop, execute, run_command, read_file, write_file, list_files, get_status, cleanup, and reset — so it works anywhere the other cloud backends work.

Configuration

SandboxConfig.novita() sets sandbox_type="novita" and reuses the shared sandbox settings.

The sandbox honours the shared resource_limits.timeout_seconds from SandboxConfig when creating the remote environment.

from praisonaiagents import Agent, SandboxConfig
from praisonaiagents.sandbox import ResourceLimits

config = SandboxConfig.novita()
config.resource_limits = ResourceLimits(timeout_seconds=120)

agent = Agent(
    name="DataAnalyst",
    instructions="Analyze data with Python.",
    sandbox=config,
)
agent.start("Read CSV data and create a summary")

Use the Backend Directly

Import NovitaSandbox when you want the isolated runtime without an Agent.

import asyncio
import os
from praisonai_sandbox import NovitaSandbox

os.environ["NOVITA_API_KEY"] = "your-api-key"

async def main():
    sandbox = NovitaSandbox()
    result = await sandbox.execute("print('Hello, World!')")
    print(result.stdout)
    await sandbox.cleanup()

asyncio.run(main())

Best Practices

Related