Installation

Install the Python SDK and Playwright. The hardened stealth binary auto-downloads on your first launch, so there is no separate Chrome to install.

Install

Capium is driven by stock Playwright, which you install and update as a normal dependency.

install.sh

pip install capium
pip install -U playwright            # the driver, updatable independently
python -m playwright install-deps    # Chromium's OS libraries (once)

Host requirements

Python: 3.9 or newer.
Platforms: Linux, Windows and macOS (Apple Silicon).
Disk: room for one Chromium-class binary per platform (a few hundred MB), cached after first download.
Windows font metrics: a Windows persona that enables --fingerprint-windows-font-metrics needs real Windows fonts on the host. Leave it off on non-Windows hosts.

Headless Linux servers

Headed mode is the recommended, most stealthy way to run Capium. On a server with no display, run it headed under a virtual display (Xvfb) rather than in true headless mode.

server.sh

# Headless Linux server: run the browser HEADED under a virtual
# display. Headed is the recommended, most stealthy mode.
Xvfb :99 -screen 0 1920x1080x24 &
export DISPLAY=:99

python your_script.py

server.py

from capium import launch_context

# On a headless box with Xvfb running (see above), launch headed.
browser, ctx, page = launch_context(
    seed=200123, platform="linux",
    headless=False,
    url="https://example.com",
)
print(page.title())
browser.close()

License

Set your key once via CAPIUM_LICENSE_KEY or ~/.capium/license, or pass license_key= to a launch call. See Quickstart for the activation flow.

Bring your own binary

For pinned, offline, or air-gapped installs you can skip the auto-download and point the SDK at a binary directly. You can also drop a capium-<version>-<platform>/ folder next to your package or working directory and it is auto-discovered.

binary.sh

# Point the SDK at a binary you already have...
export CAPIUM_BINARY=/path/to/capium-151-linux-x64/capium

# ...or a direct download URL for air-gapped / pinned installs
export CAPIUM_DOWNLOAD_URL="https://.../{platform}/{version}.tar.gz"

Upgrading

Your license entitles you to the latest hardened build. Upgrade the SDK and driver with pip install -U capium playwright; the newest matching binary is fetched on the next launch. Pin a specific binary with CAPIUM_BINARY if you need a fixed version.

Quickstart

Seeds & personas