Sandbox Python client - CoreWeave Docs

The cwsandbox Python client provides a high-level SDK for creating and managing CoreWeave sandbox environments. It supports both synchronous and asynchronous workflows through a unified API.

CoreWeave sandboxes are in public preview. For access, contact your CoreWeave account team, CoreWeave Support, or email support@coreweave.com.

Installation

uv pip install cwsandbox

Quick start

Create a sandbox, run a command, and retrieve the result:

from cwsandbox import Sandbox

# Context manager for automatic cleanup
with Sandbox.run(container_image="python:3.11") as sb:
    result = sb.exec(["python", "-c", "print(2 + 2)"]).result()
    print(result.stdout)  # 4

The same API works in async contexts:

from cwsandbox import Sandbox

async with Sandbox.run() as sb:
    result = await sb.exec(["python", "-c", "print(2 + 2)"])
    print(result.stdout)  # 4

Next steps

Get started

End-to-end walkthrough from creating a profile and deploying a runner to running your first sandbox from the SDK.

Tutorial

Step-by-step walkthrough of configuration, command execution, file operations, and cleanup with the SDK.

Guides

In-depth guides about specific topics including lifecycle management, file operations, execution patterns, and troubleshooting.

Last modified on May 29, 2026

​Installation

​Quick start

​Next steps

Get started

Tutorial

Guides

Installation

Quick start

Next steps