solari-desktop (Python)

Python SDK for Solari Desktop — managed, hardware-isolated Linux desktops with a computer-use action API (mouse, keyboard, screenshot), driven over a WebSocket control channel. Mirrors the TypeScript @solarisdk/desktop package.

Capabilities and limits at a glance: https://docs.getsolari.com/sdk-capabilities.

Install

pip install solari-desktop

Quickstart

import asyncio, os
from solari_desktop import DesktopClient

async def main():
    client = DesktopClient(api_key=os.environ["SOLARI_API_KEY"])
    desktop = await client.create()          # managed Linux desktop
    try:
        await desktop.connect()
        png = await desktop.screenshot()     # PNG bytes
    finally:
        await desktop.kill()
        await client.aclose()

asyncio.run(main())

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

Synchronous use

SyncDesktopClient takes the same arguments and returns synchronous handles (every method runs to completion on the client's own event loop):

import os
from solari_desktop import SyncDesktopClient

with SyncDesktopClient(api_key=os.environ["SOLARI_API_KEY"]) as client:
    desktop = client.create()
    try:
        desktop.connect()
        png = desktop.screenshot()
    finally:
        desktop.kill()

Docs: https://getsolari.com