mosaic-sandbox 0.1.1

Python SDK for Mosaic Sandbox (MAR)

Mosaic Sandbox Python SDK

mosaic-sandbox is the Python SDK and CLI for Mosaic Sandbox, a Firecracker-based runtime for coding agents.

Install:

python -m pip install mosaic-sandbox

Authenticate once with the CLI:

mar auth --token msk_live_...
mar whoami

Run the CLI smoke test:

mar doctor
mar run --template node-20 node -v
mar ssh <sandbox-id> --print-command

Or run the one-command first-run check:

mar smoke

Python example:

from mosaic_sandbox import Sandbox

sbx = Sandbox.create(
    template="node-20",
    endpoint="https://sandbox.mosaicos.com",
    api_token="msk_live_..."
)

try:
    result = sbx.run_command("node -v")
    print(result.stdout)
    print(result.tti_ms)
finally:
    sbx.destroy()

Docs: https://sandbox.mosaicos.com/docs/