concave-sandbox 0.1.43

Python SDK for the Concave sandbox service - isolated code execution environments

What's this?

This is a Python SDK for creating and managing sandboxes. These sandboxes run at scale on our infrastructure, while you can focus on using them to do anything you want.

Well, what can I do with it?

Run untrusted AI generated code, power deep research systems, environment for coding agents, train RL agents, malware analysis, or build interactive compute experiences—all in secure, high-performance sandboxes.

Features

• Secure Isolation: Complete VM-level isolation using Firecracker microVMs—every sandbox runs in its own kernel (unlike Docker containers that share the host kernel)
• Python Execution: Run Python code securely in isolated sandboxes
• Blazing Fast: Full VM boot up in under 200ms
• Simple API: Clean, intuitive interface with easy-to-use client SDKs
• Production Ready: Comprehensive error handling and type hints

Installation

pip install concave-sandbox

Quick Start

Get Your API Key

Sign up at concave.ai to get your API key.

Run Python Code

Execute Python code securely in isolated sandboxes:

from concave import sandbox

with sandbox(name="python-sandbox", api_key="api_key_here") as sbx:
    result = sbx.run("print(668.5 * 2)")
    print(result.stdout) 
    
# Output: 1337.0

Manual Cleanup

If you prefer to manage the sandbox lifecycle yourself:

from concave import Sandbox

sbx = Sandbox.create(name="my-sandbox", api_key="api_key_here")

# Execute shell commands
result = sbx.execute("uname -a")
print(result.stdout)  # Linux ...

# Run Python code
result = sbx.run("print('Hello from Python!')")
print(result.stdout)  # Hello from Python!

# Clean up
sbx.delete()

List Active Sandboxes

View and manage all your active sandboxes:

from concave import Sandbox

# List all active sandboxes
sandboxes = Sandbox.list(api_key="api_key_here")
print(f"Found {len(sandboxes)} active sandboxes")

# List only the 10 most recent sandboxes
recent = Sandbox.list(limit=10, api_key="api_key_here")
for sbx in recent:
    print(f"Sandbox {sbx.sandbox_id}")
    uptime = sbx.uptime()
    print(f"  Uptime: {uptime:.1f}s")

# Clean up all sandboxes
for sbx in Sandbox.list(api_key="api_key_here"):
    sbx.delete()

Documentation

For complete API reference, advanced examples, error handling, and best practices, visit docs.concave.ai.