SDKs Overview

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

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. Make an HTTP request, take the returned CDP WebSocket URL, and pass it 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 integration with the same local API shape

SDK vs /connect

Feature	HTTP /connect	SDK
Create browser	GET /connect returns a CDP URL	connect_url() returns a CDP URL
Close browser	Automatic on disconnect	Explicit close() call
Reconnect	sessionId query parameter	reconnect_url(session_id)
VNC URL	x-vnc-url response header	Available via last_vnc_url / vncUrl
Error handling	HTTP status codes	Typed exceptions
Works with	Any CDP client directly	Any CDP client (returns URL)