Skip to main content

​
Install

The public PyPI release may not be live yet. Do not install a similarly named package. Use the approved package artifact, or inside the monorepo install the local SDK: python -m pip install -e sdk/python.
The grounding helpers need Pillow. Install the extra: pip install "glasswarp[grounding]".

​
Auth

GLASSWARP_API_KEY is missing, expired, or invalid. Create a fresh key in Console → API Keys and re-export it. Never hardcode or commit keys.

​
Rigs and sessions

The host is offline, or API access is off. Open Console → Rigs: confirm the rig is online and toggle API access on. This is the per-rig consent gate.
Verify the host stayed online (check the Console), then retry once. If it recurs, restart the host agent on the Windows machine.
Always end_session in a finally block. End stray sessions from Console → Sessions. safety_restore also runs on disconnect and END_SESSION.

​
Input and vision

Update the Windows host agent — drag primitives require a host build with mouse_down / mouse_up.
Stop guessing pixels. Use grounding: prefer list_targets / click_target, or Set-of-Mark via observe(mark=True).
Use observe() (frame + dirty + targets) instead of a bare screenshot, and send a Set-of-Mark annotated frame so the model picks a target by id.

​
Still stuck?

Check the API reference for exact request/response shapes, or watch the session live via Live View to see what the host is actually doing.