dechromium 0.12.1

Anti-detect browser built on Chromium

dechromium

Anti-detect browser built on Chromium. Manages browser profiles with isolated fingerprints — canvas, WebGL, audio, fonts, screen, navigator, timezone, and network. All spoofing is implemented in C++ inside the browser engine. No JavaScript injection, no CDP overrides.

Install

pip install dechromium
dechromium install

The first command installs the Python library. The second downloads the patched Chromium binary from GitHub Releases.

Quick start

from dechromium import Dechromium, Platform

with Dechromium() as dc:
    profile = dc.create("my-profile", platform=Platform.WINDOWS)
    browser = dc.start(profile.id)
    print(browser.ws_endpoint)  # connect with Playwright, Puppeteer, or Selenium
# browser automatically stopped on exit

Features

Feature	Details
Profile management	Create, list, update, delete profiles with full fingerprint isolation
Platform presets	Platform.WINDOWS / MACOS / LINUX sets identity, WebGL, and fonts in one call
C++ spoofing	Canvas noise, WebGL params, audio fingerprint, DOMRect noise — all at engine level
Proxy support	SOCKS5/HTTP with C++ auth, DNS leak protection, WebRTC leak protection
Font isolation	Per-profile fontconfig with platform-specific font packs
Cookie management	Import/export Chrome SQLite cookies
REST API	Optional FastAPI server — pip install dechromium[server]
Typed	PEP 561 typed, Pydantic v2 models, enum-based API with IDE autocomplete

Browser management

dechromium install                     # latest version
dechromium install 145.0.7632.116      # specific version
dechromium update                      # check for updates (hotfixes)
dechromium browsers                    # list available and installed
dechromium uninstall 145.0.7632.116    # remove a version

Multiple versions can be installed side-by-side. The library auto-selects the latest.

Configuration

Env var	Default	Description
DECHROMIUM_DATA_DIR	~/.dechromium	Base directory for profiles and browsers
DECHROMIUM_BROWSER_BIN	auto-detect	Override browser binary path
DECHROMIUM_FONTS_DIR	~/.dechromium/fonts	Font packs directory

Documentation

enbanned.github.io/dechromium

License

MIT