solari-sandbox (Python)

Python SDK for Solari Sandboxes — fast, ephemeral code sandboxes (micro-VMs) with a code interpreter, filesystem, ports, and git. Mirrors the TypeScript @solarisdk/sandbox package.

Install

pip install solari-sandbox

Quickstart

import asyncio, os
from solari_sandbox import SandboxClient

async def main():
    client = SandboxClient(api_key=os.environ["SOLARI_API_KEY"])
    sb = await client.create(template="base")
    await sb.connect()
    result = await sb.run_code("print(6 * 7)")
    print(result.stdout)                      # -> 42
    await sb.kill()

asyncio.run(main())

SandboxClient(...) accepts api_key, base_url (default https://api.getsolari.com), and call_timeout_ms. The same slr_live_… key authenticates against both the browser and desktop/sandbox APIs.

Restarting a stopped sandbox

When the guest powers itself off the sandbox goes to state stopped; the host keeps its disk. start() boots it again (a cold boot: processes and memory are gone, files on disk are kept) and returns a live handle on the fresh control URL:

sb = await client.start(sandbox_id)       # sync client: client.start(sandbox_id)
await sb.connect()

Calling it on an already-running sandbox is fine. Errors carry .status and .code: 409 NotStopped (a paused sandbox needs resume), 409 StartInProgress (poll get until it is running), 409 StoppedDiskMissing / StoppedDiskUnsafe / GoldenMismatch / DiskPlatformMismatch / DiskShaMismatch / DiskExceedsSpec / DiskOwnerMismatch (the host cannot start this disk), 409 HostCapabilityMissing (the host pool is not armed for start; not retryable), 500 StartFailed (the sandbox stays stopped with its disk, so calling again is safe), 502 StartHostError (host unreachable, retryable), NoCapacityError (503 NoCapacity or StartTimeout, retryable) and ConcurrencyLimitError (429). A stopped sandbox reports state == "stopped" from get; every other route on it answers 409 SandboxStopped (only get and kill still work). start() is not retried automatically. The gateway route is POST /sandboxes/:id/start.

Docs: https://getsolari.com