What is chromiumfish?

ChromiumFish is a fork of the Chromium browser (the open-source base for Google Chrome) that modifies the browser's internals to present a consistent, plausible browser identity rather than the default signals that automated browser sessions typically emit. The project is aimed at people who run web scrapers or automated tests and encounter bot-detection systems that reject standard headless Chromium sessions. The key difference from other similar projects is where the identity spoofing happens. Many stealth browser tools work by injecting JavaScript into pages to overwrite values like the user-agent string or canvas fingerprint. ChromiumFish instead applies its changes directly to the C++ source code of Chromium, so there are no JavaScript patches for detection scripts to find. Properties like user-agent, client hints, fonts, audio context, screen dimensions, and WebRTC behavior are all modified at the engine level. The browser also suppresses the standard automation markers that CDP (Chrome DevTools Protocol) normally exposes. The persona system works through a seed string you provide. Give it the same seed and you get the same coherent identity each time (useful for sessions that need continuity). Give it a different seed and you get a fresh, unlinkable identity. The identity values are internally consistent, so things like CPU core count and reported memory size are correlated the way a real machine would be. Canvas and WebGL fingerprinting present a separate challenge on headless Linux servers, since the software renderer (SwiftShader) gives away that no real GPU is present. ChromiumFish addresses this through an optional bridge service that routes canvas and WebGL calls to a Windows machine with a real GPU, returning results from actual hardware. The bridge is a separate optional component, not bundled in the main binary. The Python and Node packages install in one line (pip install chromiumfish or npm install chromiumfish), download the prebuilt browser binary on first use, and expose an interface that works as a drop-in replacement for standard Playwright. Prebuilt binaries are available for macOS and Linux. The project is MIT licensed.