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.5.1

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.5.1
File Size Uploaded
mosaic_sandbox-0.5.1.tar.gz 73.3 kB Details

Built distribution (wheel)

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

Total release size: 131.8 kB

Release files / mosaic_sandbox-0.5.1.tar.gz

Download URL mosaic_sandbox-0.5.1.tar.gz
Size 73.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0d0776b363e5f394d809643aece8e9ff242864242ca24be8368c8ea4c3e748fc
BLAKE2b-256 checksum
How to use checksums
9ec2a1e84d7ea653e501ea7727717147c396573c98f7c0a45032bfae29d2fb13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.13

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

Download URL mosaic_sandbox-0.5.1-py3-none-any.whl
Size 58.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9ab136d55f1950058a3b41ff6e70d28964b1401aea90bfce1ecad6bcb2626600
BLAKE2b-256 checksum
How to use checksums
0894524a23ad990f9c3a5fb4ac2fe1609d3f9c5c8ce8b5a848c5e2e9c0325b7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.13

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

This release

0.5.1 This release

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

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