hyperbrowser

What it is and what it does

Hyperbrowser is a Python SDK that provides programmatic control over remote browser sessions and isolated sandbox environments through a cloud API. It offers both synchronous and asynchronous clients, allowing developers to create browser sessions with configurable network policies, stealth modes, and screen dimensions, then control them via Playwright's CDP connection protocol.

The package wraps the Hyperbrowser service API with type-hinted request dictionaries and Pydantic response models. Beyond browser automation, it exposes sandbox management (creating, listing, and configuring containerized environments), volume management for persistent storage, and terminal access. Configuration is flexible—API keys can be passed directly, read from environment variables, or loaded from saved OAuth profiles. The SDK normalizes base URLs and supports both plain dictionaries and legacy Pydantic classes for backward compatibility.

Use it for:

• Automate web scraping or testing workflows by launching remote browser sessions with network isolation and stealth mode enabled.
• Run isolated Node.js or containerized applications in sandboxes with managed CPU, memory, and disk resources.
• Create temporary development environments with exposed ports and persistent volumes for multi-step CI/CD or testing pipelines.
• Control headless browsers programmatically from Python using Playwright, connecting over CDP to remote sessions.
• Manage browser session lifecycle and network policies (allow/deny domain lists, CIDR ranges) for security-sensitive automation.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python SDK for controlling remote browser sessions and sandboxed environments via the Hyperbrowser API, supporting both sync and async clients with Playwright integration.

Yes, if you need remote browser automation or sandbox management via the Hyperbrowser service. The SDK is actively maintained, has no known vulnerabilities, and low install friction. Verify that the Hyperbrowser backend service meets your availability and latency requirements, and that its pricing aligns with your usage volume before committing.

Install

hyperbrowser on PyPI

pip install hyperbrowser

uv add hyperbrowser

poetry add hyperbrowser

Installing hyperbrowser

Before you install

Low install friction with a pure-Python wheel and five well-established runtime dependencies. Package is actively maintained with a recent release and no known vulnerabilities.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for commercial and private projects.

Quickstart

pip install hyperbrowser

from hyperbrowser import Hyperbrowser

client = Hyperbrowser(api_key="your-api-key")
session = client.sessions.create({"use_stealth": True})
print(session.ws_endpoint)

Requires a valid Hyperbrowser API key (via constructor, HYPERBROWSER_API_KEY environment variable, or OAuth session at ~/.hx_config/auth/default.json). Browser control examples also require Playwright to be installed separately.

Verify before relying

• Whether the Hyperbrowser service itself (backend) is production-ready and what its uptime SLA is
• Pricing model and rate limits for the Hyperbrowser API service
• Performance characteristics and latency of remote browser sessions

Package facts

Evidence: hyperbrowser-1.2.0-py3-none-any.whl

Tags

More WWW/HTTP packages