# CloakHQ/CloakBrowser

> Stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 50+ tests passed.

## Fast Facts & Telemetry
- **Canonical URL**: https://githubrepo.cloud/repo/CloakHQ/CloakBrowser
- **GitHub Source**: https://github.com/CloakHQ/CloakBrowser
- **Global Rank**: #463 on GitHubRepo
- **Stars**: 32,446
- **Forks**: 2,690
- **Open Issues**: 164
- **Primary Language**: Python
- **Software License**: MIT
- **Last Commit / Push**: Oct 24, 2026
- **Topics**: ai-agents, anti-detect, antidetect-browser, bot-detection, browser-automation, captcha-bypass, chromium, cloudflare, cloudflare-bypass, fingerprint, headless-browser, playwright, puppeteer, python, recaptcha, selenium, stealth-browser, undetected, web-scraping, webscraping

## Project Overview
CloakBrowser is an open-source project written in Python: Stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 50+ tests passed.

Engineered for speed, consistency, and developer ease, it solves common hurdles in ai-agents, anti-detect, antidetect-browser. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.

## Key Features
- 87 source-level C++ patches — canvas, WebGL, audio, fonts, GPU, screen, WebRTC, network timing, automation signals, CDP input behavior
- humanize=True — human-like mouse curves, keyboard timing, and scroll patterns. One flag, behavioral detection passes
- Pro: 0.9 reCAPTCHA v3 score — human-level, server-verified
- Passes Cloudflare Turnstile, FingerprintJS, BrowserScan — tested against 50+ detection sites
- Auto-downloads the right binary — free or Pro based on your license
- pip install cloakbrowser or npm install cloakbrowser — binary auto-downloads, zero config

## Installation & Quick Start
### Linux
```bash
pip install CloakBrowser
```

### macOS
```bash
pip install CloakBrowser # or: brew install CloakBrowser
```

### Windows
```bash
pip install CloakBrowser
```

## System Requirements & Architecture
- **Supported Platforms**: macOS, Linux, Windows
- **Runtime Dependencies**: Python >= 3.9, pip, virtualenv
- **Architecture**: x86_64, ARM64 (Apple Silicon & Graviton)

## How It Works
CloakBrowser is a thin wrapper (Python + JavaScript) around a custom-built Chromium binary: 1. You install → pip install cloakbrowser or npm install cloakbrowser 2. First launch → binary auto-downloads for your platform (Chromium 146) 3. Every launch → Playwright or Puppeteer starts with our binary + stealth args 4. You write code → standard Playwright/Puppeteer API, nothing new to learn The binary includes 87 source-level patches covering canvas, WebGL, audio, fonts, GPU, screen properties, WebRTC, network timing, hardware reporting, automation signal removal, and CDP input behavior mimicking.

## Production Use Cases
### Autonomous AI Agents
Orchestrate intelligent workflows and tool-calling routines with CloakBrowser.

### Model Inference & Prompting
Integrate fast, local or cloud-hosted generative AI models directly into production code.

### Context Memory & RAG
Augment language models with dynamic vector retrieval and structured project memory.

### Developer Productivity
Automate repetitive engineering tasks, code generation, and test creation using AI agents.

## Target Audience
Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads.

## Strengths
- Active community backing with 32,446 GitHub stars and verified adoption.
- Permissive open-source distribution under the MIT license.
- Built in Python for high execution speed and developer familiarity.
- Cross-platform compatibility across modern Linux, macOS, and Windows environments.
- Clean modular design allowing flexible configuration and pipeline integration.

## Considerations
- Requires familiarity with Python and modern CLI workflows.
- Ecosystem extensions may require manual configuration depending on environment constraints.
- Active development roadmap means breaking API changes may occur across major versions.

---
*Analyzed, indexed, and verified by GitHubRepo (https://githubrepo.cloud). Free public telemetry for open source creators and developers.*