Skip to main content

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 create --template node-20 --ssh
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_...",
    enable_ssh=False,
)

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

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

Release files for mosaic-sandbox 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mosaic-sandbox 0.3.0
File Size Uploaded
mosaic_sandbox-0.3.0.tar.gz 40.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mosaic-sandbox 0.3.0
File Interpreter ABI Platform
mosaic_sandbox-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 72.4 kB

Release files / mosaic_sandbox-0.3.0.tar.gz

Download URL mosaic_sandbox-0.3.0.tar.gz
Size 40.1 kB
Tags Source
SHA-256 checksum
How to use checksums
ebd6ac786b157ba5d0aa558e571be178efaee77ba22e0c599eaf0260a80f793f
BLAKE2b-256 checksum
How to use checksums
34b4ccbe9b9cc8e6161b45aca88778dadf023bfd14d32435e655a2482c4dd627
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.8

Release files / mosaic_sandbox-0.3.0-py3-none-any.whl

Download URL mosaic_sandbox-0.3.0-py3-none-any.whl
Size 32.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23400638b7b9e90c55fdaf72857a222395fff1b7921445d9aa627bc16d554e77
BLAKE2b-256 checksum
How to use checksums
a380f260437b8b2ae48aeeef947f7e4a51485a207bc51481a9627459950f95a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.8

Release history Release notifications | RSS feed

0.14.6

2 release files

0.14.5

2 release files

0.14.4

2 release files

0.13.2

2 release files

0.12.3

2 release files

0.12.2

2 release files

0.12.1

2 release files

0.12.0

2 release files

0.11.1

2 release files

0.11.0

2 release files

0.10.0

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

This release

0.3.0 This release

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page