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.4.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.4.0
File Size Uploaded
mosaic_sandbox-0.4.0.tar.gz 56.3 kB Details

Built distribution (wheel)

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

Total release size: 101.3 kB

Release files / mosaic_sandbox-0.4.0.tar.gz

Download URL mosaic_sandbox-0.4.0.tar.gz
Size 56.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a219f3668028ebf6b63b1785020e8f13bb5128a9e780b7afdc145213ae8245f8
BLAKE2b-256 checksum
How to use checksums
85ad0380a528a7f9979a6fae4a930237825d6b5aef7c672e4642f1140f92ab14
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.4.0-py3-none-any.whl

Download URL mosaic_sandbox-0.4.0-py3-none-any.whl
Size 45.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6becc7f37de27bb3df8668eb3a484938236012429e0985c95b1b059ac43196a5
BLAKE2b-256 checksum
How to use checksums
c82595ef49b101ff52b3b68669164b75cb8791482142c66f061a5841a633a46d
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

This release

0.4.0 This release

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