Repository navigation
FAQ
Engine ownership. The anti-detect lives in C++ patches inside our own Firefox fork β not in injected JS that detectors can read. Chromium-based stealth browsers are wrappers around an engine they don't control; we control the whole stack, which also means we can fix what breaks (we've shipped fixes upstream to the Camoufox lineage ourselves).
Ghostfox is a fork of the Camoufox lineage with its own branding, a Rust MCP runtime, native captcha solvers, the debug cortex, receipts and recipes. Camoufox is the engine foundation we build on β and we track it, patch it, and contribute back (see PR #782).
Agents speak Model Context Protocol directly to the browser: 48 tools
covering observation (page_a11y β including the native accessibility-tree
source), action (click/type with receipts), evidence (recordings, diffs),
determinism (recipes: record β replay without an LLM), and debugging
(console/errors/network capture).
No. The captcha models (YOLOv8s, siamese, ddddocr OCR) run on CPU β production icon-clicks solve in ~0.5s on a plain x86_64 box. The optional vision-ensemble tools can call any vision-capable LLM, but the native solvers are fully local.
Ghostfox is a testing and research tool. Anti-detect capabilities exist for legitimate automation and research the same way they do in every stealth browser; what you test with it is your responsibility. Don't use it against targets you don't have permission to test.
Your agent's identities, cookies, and sessions never touch a third-party cloud. No browser rent, no vendor lock-in: pip, npm, Docker, or build from source.
The Troubleshooting page. If it's not there, open a Discussion β confirmed solutions get written back into the wiki.
- π¦ README
- π©Ή Troubleshooting
- π³ Cookbook
- β FAQ
- π AGENTS.md (playbook)
- π° JOURNEY.md (roadmap)