Quickstart

export GLASSWARP_API_KEY=gw_live_sk_...

import os
from glasswarp import GlasswarpClient

gw = GlasswarpClient(api_key=os.environ["GLASSWARP_API_KEY"])

# Pick an online rig with API access enabled.
rig = next(
    (r for r in gw.list_rigs() if r.online and r.api_access_enabled),
    None,
)
if rig is None:
    raise RuntimeError("No online rig with API access enabled")

session = gw.create_session(rig_id=rig.id, mode="desktop")
sid = session.session_id

try:
    # Eyes: native-resolution JPEG bytes.
    frame = gw.screenshot(sid)
    with open("first_frame.jpg", "wb") as f:
        f.write(frame.jpeg)

    # Hands: native Win32 input.
    gw.click(sid, x=500, y=400)
    gw.type_text(sid, "Hello from an agent")
    gw.key_press(sid, "Enter")
finally:
    # Always end metered sessions.
    gw.end_session(sid)