Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

1.9 KB
Raw Blame

Clients use the SDK's SpacesdClient or cua spacesd ...; SpacesdClient.call_json reaches any RPC below. Sandboxes do not require cua-spacesd: only the computer interfaces and the Spaces primitives need it. It never injects input itself; pointer and keyboard actions go to Cua Driver.

Port Carries
TCP 3211 Native gRPC (HTTP/2) and gRPC-Web (HTTP/1.1), gRPC reflection, and the HTTP routes below
UDP 3212 QUIC media datagrams (ALPN rcdp/2, certificate pinned through StreamService.OpenMedia)

The default bind is 0.0.0.0:3211 with a token and 127.0.0.1:3211 without one; a non-loopback bind without a token is refused. Clients send the env token as authorization: Bearer <token> or x-cua-env-authorization: Bearer <token> (a gateway may consume authorization). The token grants full control of the computer: never put it in a URL; browsers use tickets and signed URLs.

Route Auth Purpose
GET /health None 204 while serving, 503 while shutting down
GET, HEAD, PUT, POST /files Signed URL from CreateSignedUrl Upload and download with Range; a URL signed for PUT also takes POST multipart/form-data (the first file part, answered with [{"name","path","type"}]); 403 when expired or tampered
POST /mcp Env token Streamable-HTTP MCP over the Cua Driver tools; 501 when disabled
GET /tunnel (WebSocket) Ticket from TunnelService.Forward Port forwarding
GET /hotspot (WebSocket) Ticket from StartHotspot Reverse SOCKS egress
GET /media (WebSocket) Ticket from StreamService.OpenMedia Video (H.264) and audio (Opus), media wire v2 (libs/cua/proto/MEDIA.md)

Tickets go in ?ticket= or the WebSocket subprotocol cua.ticket.<ticket>. Tickets and signed URLs are keyed from the env token, so rotating the token revokes them.