deepagents-microsandbox

Microsandbox backend for the DeepAgents framework. This package enables DeepAgents to launch and control isolated sandbox environments using Microsandbox.

Key Features

• Sandbox Provider: Manages the lifecycle of microsandbox instances (create, list, delete).
• Sandbox Backend: Provides a standard interface for file operations and command execution within a sandbox.
• DeepAgents Integration: Fully compatible with the DeepAgents SandboxProvider and SandboxBackend interfaces.

Installation

pip install deepagents-microsandbox

Usage

from deepagents_microsandbox import MicrosandboxProvider

# Initialize the provider connecting to a microsandbox server
provider = MicrosandboxProvider(server_url="http://localhost:5555")

# Create or get a sandbox
sandbox = provider.get_or_create(sandbox_id=None)

# Execute a command
result = sandbox.execute("echo 'Hello World'")
print(result.stdout)

# Clean up
provider.delete(sandbox_id=sandbox.id)

Development

This project uses uv for dependency management.

Prerequisites

• uv installed.
• Python 3.11 or higher.

Setup

Install dependencies:

uv sync

Testing

Tests are split into unit tests (mocked) and integration tests (requiring a real server).

Run Unit Tests (Mocked) These tests mock the HTTP interactions and do not require a running server.

uv run pytest

Run Integration Tests These tests verify behavior against a real microsandbox server.

1. Start a microsandbox server in dev mode:

   msb server start --dev
   

2. Run the tests with the environment variable:

   MICROSANDBOX_DEV_SERVER=http://127.0.0.1:5555 uv run pytest