---
id: hyperbrowser
version: "1.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# hyperbrowser — Python SDK for hyperbrowser

License: permissive · Maintenance: active · Downloads: 370.3K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 370.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

remote browser automation sdk, headless browser control api, playwright remote connection, browser session management, sandbox environment api, web automation python, cdp browser control, browser-automation, remote-execution, sandbox-management

[View on SkillFed](https://skillfed.io/packages/hyperbrowser) · [View on PyPI](https://pypi.org/project/hyperbrowser/)