examples

Koyeb Sandbox Examples

A collection of examples demonstrating the Koyeb Sandbox SDK capabilities.

Quick Start

# Set your API token
export KOYEB_API_TOKEN=your_api_token_here

# Run individual examples
uv run python examples/01_create_sandbox.py

Examples

• 01_create_sandbox.py - Create and manage sandbox instances
• 02_create_sandbox_with_timing.py - Create sandbox with timing measurements
• 03_basic_commands.py - Basic command execution
• 04_streaming_output.py - Real-time streaming output
• 05_environment_variables.py - Environment variable configuration
• 06_working_directory.py - Working directory management
• 07_file_operations.py - File read/write operations
• 08_directory_operations.py - Directory management
• 09_binary_files.py - Binary file handling
• 10_batch_operations.py - Batch file operations
• 11_upload_download.py - File upload and download
• 12_file_manipulation.py - File manipulation operations
• 13_background_processes.py - Background process management (launch, list, kill)
• 14_expose_port.py - Port exposure via TCP proxy with HTTP verification
• 15_get_sandbox.py - Create a sandbox and then retrieve it by ID

Basic Usage

from koyeb import Sandbox

# Create a sandbox
sandbox = await Sandbox.create(
    image="koyeb/sandbox",
    name="my-sandbox",
    wait_ready=True,
    api_token=api_token,
)

# Execute commands
result = await sandbox.exec("echo 'Hello World'")
print(result.stdout)

# Use filesystem
await sandbox.filesystem.write_file("/tmp/file.txt", "Hello!")
content = await sandbox.filesystem.read_file("/tmp/file.txt")

# Cleanup
await sandbox.delete()

Prerequisites

• Koyeb API token from https://app.koyeb.com/account/api
• Python 3.9+
• uv package manager (or pip)