Skip to content
capzy
Login

Capium Browser. Run it locally.

Launch Capium on your own machine with a Python or Node.js SDK. Build on familiar browser automation, choose a reproducible identity, and control how many sessions run together.

Start integratingRead the full guide
Install Capium
# Python SDK
pip install capiumbrowser

# Or in a JavaScript / TypeScript project
npm install capiumbrowser
Windows, macOS and LinuxPlans measure concurrent sessions

Three steps to your first local browser

Start with Python. The SDK downloads the browser binary on first launch, so allow time and network access for that first run.

  1. Choose your license

    Open Capium Browser in the dashboard, activate a plan and copy its license key. The key is separate from your Capzy API key.

    Get your license key

  2. Install the SDK and set the key

    Install capiumbrowser with pip or npm. Set CAPIUM_LICENSE_KEY in the environment used by the process that launches the browser.

  3. Launch and close a session

    launch_context returns a browser, context and page. Work with the page as usual, then close the browser to release the session.

set_license.sh
# macOS / Linux: use the license key from your dashboard.
export CAPIUM_LICENSE_KEY='YOUR_CAPIUM_LICENSE_KEY'

# Then launch your script in this shell.
python first_browser.py
first_browser.py
from capiumbrowser import launch_context

# Set CAPIUM_LICENSE_KEY before running this script.
# The browser binary downloads on first launch.
browser, context, page = launch_context(
    seed=200123,
    humanize=True,
    url="https://example.com",
)
try:
    print(page.title())
finally:
    browser.close()
Open Capium Browser in the dashboard, activate a plan and copy its license key. The key is separate from your Capzy API key. Get your license key

A few controls worth knowing

Keep identity and process lifecycle explicit as you grow from one script to a worker fleet.

CAPIUM_LICENSE_KEYRequired · environment variable
Set the license key from your Capium dashboard. Pass it to containers and worker processes through your secret configuration.
seedOptional · identity
Reuse a seed when a workflow should present the same coherent device. Keep the same configuration as well as the seed.
humanizeOptional · interaction behavior
Enable the SDK's humanized input behavior where it suits your workflow. It does not guarantee that a target accepts every request.
urlOptional · starting page
Provide the first URL at launch, or navigate using the returned page. Close the browser in a finally block when the task ends.

Pricing

Size a plan by browsers running at the same time. Concurrent sessions are different from the total number of requests you make in a month.

Loading current prices…

A few things to know

Does Capium run on Capzy servers?

The Capium SDK runs a browser on the machine where you install it. If you want Capzy to host the browser and connect remotely over CDP, use Browser API.

Why does the first launch take longer?

The SDK downloads its browser binary on first use. Confirm that your machine can reach the download service and that the process has permission to write the browser cache.

Why is my license not detected?

Check that CAPIUM_LICENSE_KEY is set in the same shell, container or service that launches the SDK. Also confirm the license is active and that you have an available concurrent session.

Start with one local session.

Get the license key, run the Python example, then scale concurrency to your workload.

Open dashboard