undetected-chromedriver
Custom Selenium Chromedriver | Zero-Config | Passes ALL bot mitigation systems (like Distil / Imperva/ Datadadome / CloudFlare IUAM)
- 13k
- Python
- GPL-3.0
- 17 mo ago
Advanced Privacy Browser Core with Unified Fingerprint Defense: Cloudflare, Akamai, Kasada, Shape, DataDome, PerimeterX, hCaptcha, FunCaptcha, Imperva, reCAPTCHA, ThreatMetrix, Adscore
Repo botswin/BotBrowser, read from GitHub 9 min ago. botswin has not joined Take My Repo.
botswin/BotBrowser is a public repo on GitHub by botswin. Advanced Privacy Browser Core with Unified Fingerprint Defense: Cloudflare, Akamai, Kasada, Shape, DataDome, PerimeterX, hCaptcha, FunCaptcha, Imperva, reCAPTCHA, ThreatMetrix, Adscore. It declares the MIT license on GitHub. It is written mainly in TypeScript, has 2,667 stars and last changed on 2026-11-18. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-19.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Identical privacy posture on any OS • Cross-platform & WebView simulation • Fingerprint protection validated across 31+ tracking scenarios
Install | CLI Flags | Guides | Advanced Features | Changelog
BotBrowser is a privacy-first browser core designed to protect users from browser fingerprinting, a technique recognized as a privacy threat by W3C, major browser vendors, privacy regulators, and academic research (see references). It keeps fingerprint signals uniform across every platform, preventing tracking systems from collecting and correlating data to identify users. Run the same profile on Windows, macOS, or Linux and the fingerprint posture stays identical each time.
All engineering focuses on privacy research, cross-platform tracking-resistance validation, and maintaining protected environments for authorized defensive benchmarking. Review the project Legal Disclaimer and Responsible Use Guidelines before using the software.
What makes BotBrowser different: Cross-platform privacy browser core with unified fingerprint technology that prevents tracking data collection and device linkage.
| High-Fidelity, Always-Current Profiles including Android WebView and WebKit-family profile consistency, built on the latest stable Chromium so fingerprints stay aligned with current browser behavior and reduce stale-engine correlation risk | Network Stack Parity with Full-Proxy QUIC/STUN (UDP over SOCKS5) delivers Chromium-level tunneling so geo metadata does not leak and privacy labs maintain clean transport parity |
| Advanced Programmatic Control offers Playwright/Puppeteer integration with CDP leak blocking so privacy tooling leaves no telemetry residue | Distributed Privacy Consistency lets you verify privacy protection across multiple browser instances simultaneously with Mirror, synchronizing input and validating privacy posture in parallel |
| Per-Context Fingerprint enables independent fingerprint bundles per BrowserContext without spawning new processes, with millisecond-level switching and reduced memory overhead | Zero-Overhead Performance adds no measurable latency: Speedometer 3.0 within <1% of stock Chrome, zero fingerprint API overhead across macOS/Linux/Windows, 29% memory savings at scale with Per-Context Fingerprint, and a Trimmed Build (ENT Tier3) delivering 62% lower wall time and 85% faster per-context spin-up on Linux x64 |
Step 1: Download
Step 2: Launch
chrome.exe --bot-profile="C:\absolute\path\to\profile.enc" --user-data-dir="%TEMP%\botprofile_%RANDOM%"
Step 3: Verify
const browser = await chromium.launch({ headless: true, executablePath: BOTBROWSER_EXEC_PATH, args: [`--bot-profile=${BOT_PROFILE_PATH}`, '--proxy-server=socks5://usr:pwd@127.0.0.1:8989'] // or: http://usr:pwd@127.0.0.1:8989 }); const page = await browser.newPage(); await page.addInitScript(() => { delete window.__playwright__binding__; delete window.__pwInitScripts; }); await page.goto('https://abrahamjuliot.github.io/creepjs/');
Notes:
--user-data-dir with a unique temporary folder to avoid conflicts with running Chromium instances--proxy-server or per-context proxies (ENT Tier1); auto timezone/locale detection applies in both casespage.authenticate()), which disable BotBrowser's geo-detection and may leak location informationExamples: Playwright • Puppeteer
More options:
--bot-script + CDP (privileged context, earlier hook, fewer artifacts)BotBrowser ships in two builds. Both share the same fingerprint protection model, profile format, and documented CLI/CDP interfaces. Capability availability still depends on the active profile package and subscription tier.
| Standard Build | Trimmed Build (ENT Tier3) | |
|---|---|---|
| Distribution | Public releases | Enterprise channel only |
| Built for | Long-running and interactive sessions | Short-session, high-concurrency automation |
| Browser feature surface | Full | Tuned for short-session workloads |
| Fingerprint protection | Same | Same |
| Per-Context Fingerprint | Same | Same |
| Profile compatibility | Same | Same |
Linux x64 benchmark (400 official samples, 1..20 contexts × 10 repeats × 2 builds): Trimmed Build cuts wall time by 62%, per-context creation by 85%, first navigation by 38%, CPU peak by 68%, PSS peak by 31% versus Standard, with 100% success rate and 0 residual processes for both builds.
Trimmed Build is the right choice when context spin-up dominates total wall time, when CPU peak per context limits density, or when shared memory is the binding constraint. Standard Build remains the right choice for interactive workflows and scenarios that exercise the full browser feature surface.
Product overview, engineering design, FAQ: TRIMMED_BUILD.md. Full performance table: BENCHMARK.md#trimmed-build. Access: Enterprise or Pricing.
Configuration priority: CLI flags (highest) > Profile configs > defaults. Timezone, locale, and language auto-derive from your proxy IP.
| Feature | Reference | Guide |
|---|---|---|
| Proxy with embedded credentials (HTTP/HTTPS/SOCKS5/SOCKS5H/QUIC) | --proxy-server | Guide |
| QUIC proxy routing with MASQUE CONNECT-UDP | --proxy-server | Guide |
| Regex-based proxy routing rules | --proxy-bypass-rgx | Guide |
| Per-context proxy with auto geo-detection | Per-Context Fingerprint | Guide |
| Dynamic proxy switching at runtime | Dynamic Proxy Switching | Guide |
| UDP over SOCKS5 (QUIC/STUN tunneling) | UDP over SOCKS5 | Guide |
| PAC-like request callback and synthetic responses (ENT Tier3) | --proxy-pac-url |
Guide |
| Local DNS solver | --bot-local-dns | Guide |
| Port protection for local services | --bot-port-protection | Guide |
| WebRTC leak protection (SDP/ICE control) | WebRTC Leak Protection | Guide |
| Feature | Reference | Guide |
|---|---|---|
| Canvas / WebGL / WebGPU deterministic noise | Multi-Layer Noise | Canvas · WebGL |
| AudioContext noise calibration | Multi-Layer Noise | Guide |
| Text metrics & ClientRects noise | Multi-Layer Noise | Guide |
| Deterministic noise seeds (reproducible per-tenant) | --bot-noise-seed | Guide |
| Performance timing protection (27 browser operations) | Performance Timing Protection | Guide |
| Video FPS control for media workloads | --bot-video-fps | Guide |
| Stack depth fingerprint control (main/Worker/WASM) | Stack Depth Control | Guide |
| Memory and storage quota control | --bot-js-heap-size-limit / --bot-storage-quota | Guide |
| Network information policies (profile/native/custom JSON) | Network Info Privacy | Guide |
| CPU core scaling protection | CPU Core Scaling | Guide |
| Cross-platform font engine (Win/Mac/Android) | Font Engine | Guide |
| Profile-backed permission states | Complete Fingerprint Control | Guide |
| GPU simulation on headless servers | Headless Compatibility | Guide |
| Feature | Reference | Guide |
|---|---|---|
| Cross-platform profile portability (Win / Mac / Linux) | Advanced Features | Guide |
| Browser brand switching (Chrome/Edge/Brave/Opera) | --bot-browser-brand |
Guide |
| Custom User-Agent with full userAgentData control | --bot-ua-full-version |
Guide |
| Client Hints alignment (DPR, device-memory, UA-CH) | Browser & OS | Guide |
| Android WebView emulation | --bot-browser-brand |
Guide |
| WebKit-family profile consistency (ENT Tier4) | Feature Page | Guide |
| Chrome behavior emulation (HTTP/2, HTTP/3, headers) | Chrome Behavior |
| Feature | Reference | Guide |
|---|---|---|
| Playwright / Puppeteer integration | Examples | Playwright · Puppeteer |
| Framework-less bot-script (chrome.debugger API) | --bot-script | Guide |
| CDP mouse move coalescing | --bot-cdp-coalesce | Guide |
| Per-context fingerprint (multiple profiles per process) | Per-Context Fingerprint | Guide |
| Console message suppression | --bot-disable-console-message | Guide |
| Headless / GUI parity | Headless Compatibility | Guide |
| Mirror: distributed privacy consistency | Mirror Documentation | Guide |
| CanvasLab: Canvas 2D / WebGL / WebGL2 recorder and ENT Tier4 Canvas Replay | --bot-canvas-record-file | Guide |
| AudioLab: Web Audio API recorder | --bot-audio-record-file | Guide |
| V8Log Forensics and API filters | --bot-v8-log | Guide · Tool |
| Feature | Reference | Guide |
|---|---|---|
| Cookie management (inline JSON or file) | --bot-cookies | Guide |
| Bookmark injection | --bot-bookmarks | Guide |
| History injection (random or precise count) | --bot-inject-random-history | Guide |
Incognito X-Client-Data consistency |
--bot-enable-variations-in-context | Guide |
| Always-active windows (anti-focus-tracking) | Active Window | Guide |
| Custom HTTP headers (CLI + CDP) | --bot-custom-headers | Guide |
| Plaintext storage access (cookies, localStorage) | Storage Access | Guide |
| Precision FPS simulation | --bot-fps | Guide |
| Timing scale (performance.now compression) | --bot-time-scale | Guide |
| Window/screen dimension control | --bot-window | Guide |
| Mobile screen orientation control | --bot-orientation | Guide |
| Mobile keyboard visual viewport control | --bot-mobile-keyboard | Guide |
This reference maps privacy protection goals to BotBrowser implementation details and validation evidence.
| Privacy Protection | Implementation | Reference |
|---|---|---|
| API standardization | navigator.webdriver standardized across all platforms so trackers cannot use API presence/absence as identification signal | ADVANCED_FEATURES#Chrome Behavior Emulation |
| Execution environment protection | Isolated execution context prevents framework artifacts from exposing privacy leaks | ADVANCED_FEATURES#Playwright/Puppeteer Integration |
| Graphics rendering consistency | Deterministic noise across Canvas, WebGL, WebGPU, and audio ensures protected fingerprints even in GPU-dependent scenarios | ADVANCED_FEATURES#Graphics & Rendering Engine |
| GPU fingerprint uniformity | Canvas and WebGPU rendering shares deterministic properties so GPU probes like WebBrowserTools return authentic results | CHANGELOG#2025-12-08 |
| Typography consistency | Embedded font engines for Windows, macOS, Linux, and Android ensure text rendering remains identical across platforms | ADVANCED_FEATURES#Cross-Platform Font Engine |
| Font availability uniformity | DOM queries return authentic font lists from embedded bundles so host system fonts cannot leak platform identity | ADVANCED_FEATURES#Cross-Platform Font Engine |
| Device capabilities | Profile-based device properties maintain protected device claims across all platforms | Profile Configs |
| Network topology privacy | WebRTC signaling stays protected through SDP and ICE controls preventing network topology leakage | ADVANCED_FEATURES#WebRTC Leak Protection |
| User agent coherence | Browser brand and version parity prevents UA string from revealing platform differences | CLI_FLAGS#Profile Configuration Override Flags |
| Header to API parity | Client Hints headers DPR, device-memory, and UA-CH align with JavaScript reported values preventing header based identification | ADVANCED_FEATURES#Browser & OS Fingerprinting |
| Execution mode parity | GPU, WebGPU, and media signals remain identical whether running headless or in GUI mode | ADVANCED_FEATURES#Headless & Incognito Compatibility |
| DNS privacy | Use local DNS solver (ENT Tier1) for private resolution that avoids DNS leaks and provider restrictions, or use SOCKS5H to keep DNS within proxy tunnels | CLI_FLAGS#Enhanced Proxy Configuration |
| Public IP discovery | Customizable IP lookup backend for geo derivation via --bot-ip-service; comma-separated endpoints are tried one at a time, with fallback when the active endpoint is unavailable |
CLI_FLAGS#--bot-ip-service |
| Protocol conformance | HTTP/2 and HTTP/3 behavior matches Chrome specifications preventing protocol based differentiation | ADVANCED_FEATURES#Chrome Behavior Emulation |
| TLS behavior consistency | Network protocol behavior aligned with the active profile family across supported platforms | CHANGELOG |
| DRM capability consistency | Widevine persistent license support with platform-appropriate license negotiation prevents tracking via EME capability fingerprinting | ADVANCED_FEATURES |
| Authentication capability uniformity | WebAuthn client capabilities return platform-specific values preventing tracking via Touch ID, Bluetooth authenticator, and payment extension detection | ADVANCED_FEATURES |
Fingerprint Protection Matrix: Cross-Platform Coverage
| Category | Sample Capabilities |
|---|---|
| Graphics | Canvas/WebGL rendering, GPU micro-benchmarks, texture hash configuration |
| Network | WebRTC SDP configuration, proxy auth, connection management |
| Platform | Font fallback chains, cross-worker protection, OS-specific features |
| Performance | FPS simulation, memory timing, animation frame optimization |
Advanced Features (architecture & design) → | CLI Flags (all options) →
Fingerprint protection validated across 31+ tracking scenarios. See DISCLAIMER for authorized use.
Complete Validation Results & Research Data →
BotBrowser's engine is built in-house on top of Chromium, with no forks or external project dependencies. Selected patch examples, build configurations, and the Chromium source directory tree are published in patches/. The full core remains proprietary.
| Website | Documentation, guides, blog | botbrowser.io |
| Technical questions, source code access | support@botbrowser.io | |
| Telegram | Community support, quick questions | @botbrowser_support |
Legal Disclaimer & Terms of Use • Responsible Use Guidelines. BotBrowser is for authorized fingerprint protection and privacy research only.
botswin/BotBrowser is a public repo on GitHub by botswin. Advanced Privacy Browser Core with Unified Fingerprint Defense: Cloudflare, Akamai, Kasada, Shape, DataDome, PerimeterX, hCaptcha, FunCaptcha, Imperva, reCAPTCHA, ThreatMetrix, Adscore.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-18. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Custom Selenium Chromedriver | Zero-Config | Passes ALL bot mitigation systems (like Distil / Imperva/ Datadadome / CloudFlare IUAM)
🛡️ Open-source and cloud-native Web Application Firewall (WAF)
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
invisible playwright: Playwright that anti-bots cannot see, so no captchas: same API, anti-detect stealth headless Firefox, undetected fingerprint, bypass bot detection, Python web scraping and browser automation.

Pydoll is a library for automating chromium-based browsers without a WebDriver, offering realistic interactions.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
Hosted privacy browser fleet with consistent fingerprints for authorized research
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/botswin/BotBrowserTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.