Back to home

Capium Browser guide

Capium is a stealth browser you drive with the Playwright API you already know. This guide takes you from install to your first live session in a few minutes.

1Install the toolkit

The stealth binary downloads on first launch, so there's no separate Chrome to install. Install the Python SDK and the Playwright driver:

install.sh
pip install capium
python -m playwright install-deps   # Chromium's OS libraries (once)

2Get your license key

Create a free account on Capzy and open the Capium dashboard. Your license key is on the dashboard, it unlocks the always-latest stealth binary and works on Linux, Windows and macOS.

3Run your first session

Paste your key and drive the page. Turn on humanize for human-like input and timing:

first_run.py
from capium import launch_context

# License comes from CAPIUM_LICENSE_KEY or ~/.capium/license.
# launch_context returns (browser, context, page).
browser, ctx, page = launch_context(
    seed=200123, humanize=True,
    url="https://example.com",
)
print(page.title())
browser.close()

4Use a proxy

Capium runs locally, so it uses your egress by default. Point a session at any proxy you control:

proxy.py
from capium import launch_context

# Route a session through your own proxy (HTTP or socks5://).
# geoip aligns timezone, geo and the WebRTC IP to the exit.
browser, ctx, page = launch_context(
    seed=200123,
    proxy="http://user:pass@host:port",
    geoip=True,
    url="https://example.com",
)

5Go async

For concurrent sessions, use the async driver, one browser per concurrency slot on your plan:

async.py
import asyncio
from capium import launch_context_async

async def main():
    browser, ctx, page = await launch_context_async(
        seed=200123, url="https://example.com",
    )
    print(await page.title())
    await browser.close()

asyncio.run(main())

Ready to run a live session?

The free tier runs a real stealth session, no card required.

Start free