Skip to content
View antibrow's full-sized avatar

Block or report antibrow

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
antibrow/README.md

AntiBrow
The antidetect browser your AI agent can drive.

English | Русский

PyPI npm MIT Website


Kernel-level fingerprint spoofing, driven by the standard Playwright API you already write. Every profile carries a coherent real-device fingerprint — canvas, WebGL, WebGPU, audio, fonts, WebRTC and the protocol layer all agree, because they were sampled from one real machine rather than randomized independently.

This repository holds the open-source SDKs. See Licensing for what is and isn't open.

python/   →  PyPI: antibrow
js/       →  npm:  anti-detect-browser

Install

Python

pip install antibrow
from antibrow import launch

browser = launch()                      # engine downloads on first run
page = browser.new_page()
page.goto("https://example.com")
browser.close()

JavaScript / TypeScript

npm install anti-detect-browser playwright-core
import { openProfile } from 'anti-detect-browser'

const session = await openProfile({ key: process.env.ANTIBROW_KEY, profileName: 'default' })
const page = await session.context.newPage()
await page.goto('https://example.com')
await session.close()

Both SDKs speak the same on-disk format: a profile created by one is launchable by the other, with the identical fingerprint.

What you get

  • Engine-level spoofing, not JS injection. Fingerprints are produced inside Chromium's C++ layer, so there are no toString / prototype / stack-trace tells for a detector to find.
  • Coherent real-device profiles. 30+ categories, 500+ parameters, all drawn from the same real machine. Randomized values contradict each other; these don't.
  • Android profiles on a desktop machine. device_type="android" (deviceType: 'android' in JS) gives a profile a real phone's identity - mobile client hints, touch input, portrait screen, mobile GPU - with no device farm and no remote hardware. Real phones ship inside both packages, so it works on the free tier.
  • Timezone and locale follow the proxy. Pass a proxy and the exit IP's geo is resolved and written into the fingerprint before launch.
  • Proxy auth handled in the engine. http / https / socks5 credentials go inline on --proxy-server; the kernel answers the challenge itself. No helper extension is loaded, so nothing shows up in chrome://extensions.
  • Persistent identities. Cookies, storage and passkeys survive restarts — warm an account once and it stays warm.
  • Standard Playwright. You get a normal BrowserContext over CDP. No proprietary API to learn, and existing scripts port over by changing how the browser is launched.
  • MCP server mode, so an AI agent can drive a profile directly.

Docs and examples

Python API, options, CLI python/README.md
JavaScript API js/README.md
Runnable examples (Playwright, browser-use, crawl4ai, Scrapling, MCP, Docker) python/examples/

Platforms

Windows x64, macOS (universal) and Linux x64 / arm64.

Licensing

Read this before you build on it — the SDK and the engine have different licenses.

  • The SDKs in this repository are MIT (LICENSE). Use them anywhere, including commercially.
  • The browser engine is a closed-source binary distributed separately, under BINARY-LICENSE.md. In short: you may use it for your own work, including commercial work, at any company size — but you may not redistribute, resell, repackage or embed it, and exposing it to third-party customers (bundled, hosted, or behind your own API) needs a separate OEM/SaaS license.
  • Listing these packages as a dependency is not redistribution, because the engine is downloaded from official AntiBrow channels on the user's own machine.

BINARY-LICENSE.md is the authoritative text; the summary above is not a substitute for it.

Acceptable use

Automating systems without authorization, credential stuffing and bulk account-creation abuse are prohibited. You are responsible for complying with the terms of the sites you automate and with the law in your jurisdiction.

Links

Popular repositories Loading

  1. anti-detect-browser-skills anti-detect-browser-skills Public

    Launch and manage anti-detect browsers with unique real-device fingerprints for multi-account operations, web scraping, ad verification, and AI agent automation.

    9

  2. antibrow antibrow Public

    Kernel-level antidetect browser with the Playwright API you already write. Python + Node SDKs, MCP-ready, unlimited local profiles. Linux x64 + arm64, macOS Intel + Apple Silicon, Windows x64.

    TypeScript 2

  3. hermes-agent hermes-agent Public

    Forked from NousResearch/hermes-agent

    The agent that grows with you

    Python

  4. awesome-playwright awesome-playwright Public

    Forked from mxschmitt/awesome-playwright

    A curated list of awesome tools, utils and projects using Playwright

  5. dsh-antibrow dsh-antibrow Public

    DeepSeek Harness plugin: give your agent a browser with a persistent identity - engine-level fingerprint spoofing, unlimited free local profiles, Android device emulation, passkeys that survive, an…

    JavaScript

  6. homebrew-tap homebrew-tap Public

    Official Homebrew tap for AntiBrow, an antidetect browser with a patched Chromium kernel

    Shell