nokk (Python)

Undetectable headless-browser engine, one pip install away.

nokk is a lightweight, Chrome-fingerprinted headless-browser engine (V8 + a minimal DOM, no rendering) that speaks the Chrome DevTools Protocol. This package embeds the prebuilt nokk binary — there is no browser to download, no Rust toolchain to install, and no Docker. pip install nokk, call launch(), and connect your existing Playwright or pyppeteer script over CDP.

pip install nokk

Alpha: prebuilt wheels are currently Linux x86_64 only. macOS/Windows wheels are on the roadmap.

Quick start

Playwright

import nokk
from playwright.sync_api import sync_playwright

with nokk.launch() as server, sync_playwright() as pw:
    browser = pw.chromium.connect_over_cdp(server.ws_endpoint)
    page = browser.new_page()
    page.goto("https://example.com")
    print(page.title())

pyppeteer

import asyncio, nokk
from pyppeteer import connect

async def main():
    with nokk.launch() as server:
        browser = await connect(browserWSEndpoint=server.ws_endpoint)
        page = await browser.newPage()
        await page.goto("https://example.com")
        print(await page.title())

asyncio.run(main())

launch() options

nokk.launch() starts the CDP server on a free port and returns a NokkServer (a context manager). All arguments are keyword-only:

# Each browser context looks like a different machine, timezone matched to its proxy.
with nokk.launch(rotate_fingerprint=True, geoip_timezone=True) as server:
    ...

The server also shuts down automatically at interpreter exit; with or server.close() stops it immediately.

Point at a locally built binary during development with the NOKK_BINARY environment variable.

Links

• Source & docs: https://github.com/koloss777/nokk
• Issues: https://github.com/koloss777/nokk/issues

Licensed under either of MIT or Apache-2.0, at your option.