Skip to content

abencat/abencat-browser

Repository files navigation

🐱 Abencat Browser · 阿笨猫指纹浏览器

Open-source anti-detect fingerprint browser — multi-profile isolation, a built-in automation HTTP API + MCP server, Windows / Linux, headed & headless. Free forever.

🌐 browser.abencat.com · Languages: English · 简体中文 · 日本語 · 한국어 · Русский · Español · Français · Deutsch

License: MIT Release Stars Website Platforms


Fingerprint kernel credit: the fingerprint isolation is provided by CloakBrowser © CloakHQ — a stealth Chromium with source-level fingerprint patches. Abencat Browser is an open-source controller / launcher around that kernel. The kernel is not redistributed in this repo; download it with the script below. All credit for the browser engine goes to CloakHQ. See NOTICE.

✨ Features

  • Fingerprint isolation — Canvas / WebGL / Audio / Fonts / WebRTC, per-profile seed; passes bot detection (via CloakBrowser kernel).
  • Automation API — every launch auto-allocates a debug port and returns a CDP WebSocket; connect Puppeteer / Playwright / Selenium instantly.
  • MCP server — AI agents (Claude, Cursor, …) create / start / control environments directly. See AGENT_AUTOMATION.md.
  • Proxy pool + GeoIP — bulk import, health checks, auto-sync language / timezone / exit IP from the proxy.
  • Local encryption — proxy passwords & cookies encrypted at rest (AES-256-GCM), optional Argon2id master password.
  • Cross-platform & headless — Windows desktop + Linux server; switch headed/headless per launch.
  • i18n — UI in 8 languages (zh/en full + ja/ko/ru/es/fr/de).

📦 Download

All downloads are hosted on browser.abencat.com (the GitHub Release carries source archives only).

Full bundle — includes the browser kernel, ready to run (no extra download):

Platform Download
🪟 Windows x64 abencat-windows-x64-full.zip (225 MB) — unzip & run Abencat Browser.exe
🐧 Linux x86_64 abencat-linux-x64-full.tar.gz (210 MB) — extract & run ./cloak-headless

Controller only — tiny, auto-downloads the kernel on first run:

Platform Headed (GUI) Headless (server)
Windows installer (5 MB) cloak-headless.exe
Linux x86_64 desktop build (needs webkit2gtk) / xvfb-run cloak-headless

Fingerprint kernel (standalone): Windows zip · Linux tar.gz

🚀 Quick start

# 1) Get the CloakBrowser fingerprint kernel (not shipped in this repo)
./scripts/download-browser.sh           # Linux/macOS
#  scripts\download-browser.ps1          # Windows (PowerShell)

# 2a) Desktop app — just run the installer / executable.

# 2b) Headless server (Windows/Linux)
export CLOAKBROWSER_BINARY_PATH=/opt/cloakbrowser/chrome   # or use the script's output
./cloak-headless
#   → http://127.0.0.1:50327  + a token (printed once)

📖 Step-by-step tutorial: Let AI drive an anti-detect browser (MCP) · 中文教程

Drive it over HTTP or MCP — full guide in AGENT_AUTOMATION.md:

GET /api/v1/browser/start?id=<id>&headless=1&token=<token>
# → { "ws": "ws://127.0.0.1:42555/devtools/browser/...", "debuggerAddress": "127.0.0.1:42555" }

🛠 Build from source

# Frontend + desktop app (Windows/macOS/Linux desktop)
npm install
npm run tauri:build                 # → installer under src-tauri/target/release/bundle

# Headless server binary (no Tauri/webkit, great for Ubuntu servers)
cd src-tauri
cargo build --release --bin cloak-headless --no-default-features

Toolchain: Rust (stable), Node ≥18. Linux desktop build needs libwebkit2gtk-4.1-dev and friends — see LINUX_HEADLESS.md.

📂 Layout

src-tauri/src/   Rust backend (models, store, crypto, proxy, launch, api, commands, …)
src/             React/TS frontend (App.tsx, i18n.ts, components/)
mcp/             MCP server (cloak-mcp.mjs)
website/         landing page (browser.abencat.com, 8 languages)
docs/            multi-language README + guides
scripts/         download-browser.{sh,ps1}

📜 License

MIT © Abencat Browser. Fingerprint kernel © CloakHQ (CloakBrowser).

About

Open-source fingerprint browser controller, powered by CloakBrowser. 阿笨猫指纹浏览器 — automation API + MCP, Windows/Linux, headed & headless.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors