# Clearcote Browser

> An open-source, reproducible Chromium build with engine-level privacy and identity controls. De-Googled base (ungoogled-chromium) plus a transparent, readable patch set. Designed as a drop-in for Playwright/Puppeteer automation. **Windows x64 only for now** — that is the single platform currently focused on (the Windows binary is cross-compiled on Linux); macOS and Linux targets are on the roadmap, not yet available. 100% open — every change is a patch, every build is reproducible and checksummed.

## Status
Pre-release, building in the open. Latest signed browser build: v0.1.0-pre.6 (Chromium 149, Windows x64) on GitHub Releases. Python + Node SDKs published as `clearcote` (PyPI + npm). See /ROADMAP.md.

## Principles
- Open by default (no proprietary blobs; readable patches only)
- Engine-level controls, not injected JavaScript
- Coherent, per-site-consistent identity (farbling-style model)
- Engine-level coherence pass: secondary surfaces (WebGL limits/unmasked GPU, getBattery, navigator.connection, keyboard layout, AudioContext, screen details) stay consistent with the persona and a real Chrome-on-Windows desktop
- In-browser AI agent: a native, in-process agent (perceive the page -> ask an LLM -> act via Chrome's Actor framework with real trusted input, not injected JS), usable with OpenRouter or any OpenAI-compatible endpoint; switch models with a single slug. SDK: launch_agent()/launchAgent() + run_agent_task()/runAgentTask()
- Reproducible and verifiable (pinned upstream, checksums, planned attestation)
- Lawful, responsible use

## Key docs
- /README.md — what it is, why, quickstart, credits
- /ROADMAP.md — phased plan and future
- /docs/BUILDING.md — build from source
- /docs/VERIFY.md — verify a release (don't trust, verify)
- /docs/CANVAS-BRIDGE.md — run the optional real-GPU canvas bridge (forward canvas/WebGL ops to a remote GPU host so readbacks are coherent with the GPU you present; opt-in via --canvas-bridge-url)
- /AGENTS.md — contributor & automation guide
- /CREDITS.md — upstream attributions and licenses
- /DISCLAIMER.md — responsible use and legal

## Inspiration (all open source)
- Chromium (BSD-3)
- ungoogled-chromium (BSD-3) — de-Googled base
- fingerprint-chromium by adryfish (BSD-3) — engine-level fingerprint controls
- chromiumfish by arman-bd (MIT) — coherence-surface reference (battery, navigator.connection, keyboard, display, WebGL limits), the in-browser AI-agent layer Clearcote ports + adapts to OpenRouter, and the canvas-bridge concept (remote real-GPU rendering) Clearcote re-implements clean-room
- Brave — per-site deterministic "farbling" model
- Camoufox — sibling open anti-detect browser (Firefox), design reference

## Not
Not affiliated with or derived from any commercial product. Ships no third-party proprietary code. Not a tool for unlawful activity.