mosaic-sandbox 0.1.0

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

Set your endpoint and API token:

export MAR_ENDPOINT=https://sandbox.mosaicos.com
export MAR_API_TOKEN=msk_live_...

Run the CLI smoke test:

mar doctor
mar run --template node-20 node -v

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/