Documentation Index
Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
Use this file to discover all available pages before exploring further.
This guide covers resource management and cleanup strategies for sandboxes.
Automatic cleanup
Context managers (recommended)
Sandboxes are stopped when exiting the context:
from cwsandbox import Sandbox
with Sandbox.run() as sandbox:
result = sandbox.exec(["echo", "hello"]).result()
# sandbox.stop() called automatically
import cwsandbox
from cwsandbox import SandboxDefaults
with cwsandbox.Session(SandboxDefaults(container_image="python:3.11")) as session:
sb1 = session.sandbox()
sb2 = session.sandbox()
# Both sandboxes stopped automatically
Global cleanup handlers
The SDK registers cleanup handlers for process termination:
| Scenario | Behavior |
|---|
| Normal script exit | atexit handler stops all sandboxes |
| Ctrl+C (SIGINT) | Signal handler stops all sandboxes |
| SIGTERM | Signal handler stops all sandboxes |
| Second Ctrl+C | Force exit (prevents hang) |
Manual cleanup
stop()
sandbox = Sandbox.run()
result = sandbox.exec(["echo", "hello"]).result()
sandbox.stop().result()
# With options
sandbox.stop(graceful_shutdown_seconds=30.0).result()
sandbox.stop(snapshot_on_stop=True).result()
Session close()
from cwsandbox import SandboxDefaults
session = cwsandbox.Session(SandboxDefaults(container_image="python:3.11"))
sandbox = session.sandbox()
# ...
session.close().result() # Stops all sandboxes
Batch cleanup
from cwsandbox import results
sandboxes = [Sandbox.run() for _ in range(5)]
# ... use sandboxes ...
results([sb.stop() for sb in sandboxes]) # Stop all in parallel
Orphan management
Tagging for discovery
The SDK’s automatic cleanup handlers prevent most orphans, but sandboxes can still be left running after forced shutdowns (kill -9), network failures, or when creating sandboxes outside of sessions and context managers. Use tags to make any orphans easily discoverable.
from cwsandbox import Sandbox, SandboxDefaults
# Tag at creation time
defaults = SandboxDefaults(
container_image="python:3.11",
tags=("my-project", "batch-job-123"),
)
with Sandbox.run(defaults=defaults) as sandbox:
result = sandbox.exec(["echo", "hello"]).result()
- Project or application name (
my-project)
- Job or run identifier (
batch-job-123, run-2024-01-15)
- Environment (
dev, staging, prod)
Finding orphaned sandboxes
Query by tags to find sandboxes from previous runs:
from cwsandbox import Sandbox
orphans = Sandbox.list(tags=["my-project"]).result()
for sandbox in orphans:
sandbox.stop().result()
Session adoption
Bring orphans under session management for automatic cleanup:
import cwsandbox
from cwsandbox import SandboxDefaults
with cwsandbox.Session(SandboxDefaults(container_image="python:3.11")) as session:
orphans = session.list(tags=["my-project"]).result()
for sandbox in orphans:
session.adopt(sandbox)
# All adopted sandboxes cleaned up with session
Deleting by ID
from cwsandbox import Sandbox
Sandbox.delete("sandbox-abc123").result()
Sandbox.delete("sandbox-abc123", missing_ok=True) # Ignore if gone
