SDKs Overview

rayobrowse provides official SDKs for Python and Node.js/TypeScript. Both work with local self-hosted instances and the cloud service.

Python SDK

pip install rayobrowse

Python quickstart →

Node.js SDK

npm install rayobrowse

Node.js quickstart →

Do I need the SDK?

The /connect endpoint works without any SDK — just pass a WebSocket URL to your CDP client. The SDKs are useful when you want:

• Programmatic control over browser creation and lifecycle
• Session reconnection
• VNC URL retrieval
• Typed error handling (auth, rate limits, concurrency)
• Cloud mode integration (the SDK handles the HTTP handshake to get the direct CDP URL)

SDK vs /connect

Feature	/connect URL	SDK
Create browser	Automatic on WebSocket connect	Explicit connect_url() call
Close browser	Automatic on disconnect	Explicit close() call
Reconnect	Not supported	reconnect_url(session_id)
VNC URL	Not returned	Available via last_vnc_url / vncUrl
Error handling	HTTP status codes	Typed exceptions
Works with	Any CDP client directly	Any CDP client (returns URL)