Metadata-Version: 2.4
Name: rayobrowse
Version: 2.2.0
Summary: Lightweight client SDK for the Rayobrowse stealth browser platform
Author-email: Rayobyte <support@rayobyte.com>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://rayobyte.com
Project-URL: Documentation, https://docs.rayobrowse.com
Keywords: browser,automation,stealth,scraping,playwright,anti-detect,fingerprint
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.25

# Rayobrowse SDK

Lightweight Python SDK for the [Rayobrowse](https://rayobyte.com) stealth browser platform.
Works with both local self-hosted instances and the Rayobrowse cloud service.

## Installation

```bash
pip install rayobrowse
```

## Quick Start

```python
from rayobrowse import Rayobrowse
from playwright.sync_api import sync_playwright

client = Rayobrowse(endpoint="wss://cloud.rayobrowse.com", api_key="your-key")
ws_url = client.connect_url(os="windows", proxy="http://user:pass@host:port")

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(ws_url)
    page = browser.new_page()
    page.goto("https://example.com")
    print(page.title())
    browser.close()
```

### Local Usage (Docker)

```python
from rayobrowse import Rayobrowse
from playwright.sync_api import sync_playwright

client = Rayobrowse()  # defaults to ws://localhost:9222
ws_url = client.connect_url(os="windows")

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(ws_url)
    page = browser.new_page()
    page.goto("https://example.com")
    browser.close()
```

## Documentation

Full documentation, API reference, and integration guides are available at
[docs.rayobrowse.com](https://docs.rayobrowse.com).

## Links

- [Homepage](https://rayobyte.com)
- [Documentation](https://docs.rayobrowse.com)
- [Support](mailto:support@rayobyte.com)
