Skip to main content
Sandbox provides secure, isolated containers for executing shell commands.

Agentic Sandbox Tools

Give your agent command execution with pre-built tools.

Quick Start

1

Create a sandbox

import os
from acontext import AcontextClient

client = AcontextClient(api_key=os.getenv("ACONTEXT_API_KEY"))
sandbox = client.sandboxes.create()
2

Execute commands

result = client.sandboxes.exec_command(
    sandbox_id=sandbox.sandbox_id,
    command="echo 'Hello!' && python3 --version"
)
print(f"stdout: {result.stdout}")
print(f"exit_code: {result.exit_code}")
3

Kill sandbox

client.sandboxes.kill(sandbox.sandbox_id)

Disk Integration

Transfer files between disk and sandbox:
1

Setup

from acontext import FileUpload

disk = client.disks.create()
sandbox = client.sandboxes.create()

# Upload file to disk
client.disks.artifacts.upsert(
    disk.id,
    file=FileUpload(filename="input.txt", content=b"Line 1\nLine 2"),
    file_path="/input/"
)
2

Download to sandbox

client.disks.artifacts.download_to_sandbox(
    disk_id=disk.id,
    file_path="/input/",
    filename="input.txt",
    sandbox_id=sandbox.sandbox_id,
    sandbox_path="/workspace/"
)
3

Process in sandbox

client.sandboxes.exec_command(
    sandbox_id=sandbox.sandbox_id,
    command="wc -l /workspace/input.txt > /workspace/output.txt"
)
4

Upload result to disk

client.disks.artifacts.upload_from_sandbox(
    disk_id=disk.id,
    sandbox_id=sandbox.sandbox_id,
    sandbox_path="/workspace/",
    sandbox_filename="output.txt",
    file_path="/output/"
)
5

Clean up

client.sandboxes.kill(sandbox.sandbox_id)
# Disk persists after sandbox is killed

Next Steps