Skip to content

The headless browser for AI agents and web scraping

2.4 KB
Raw Blame

Obscura documentation

Official documentation for Obscura, maintained in this repository.

Obscura is an independent headless browser engine written in Rust. It runs JavaScript through V8 and provides a Chrome DevTools Protocol endpoint for Puppeteer and Playwright. These docs describe the code on main; installed release versions may differ.

Versus headless Chrome

Metric Obscura Headless Chrome
Memory 30 MB 200+ MB
Binary size ~70 MiB 300+ MB
Startup Instant ~2s
Page load 85 ms ~500 ms
Anti-detect Built-in None
Puppeteer Yes Yes
Playwright Yes Yes

Rendering and stealth are both first-class capabilities. Release builds support screenshots, scroll-aware layout, activity-driven CDP screencasting, and raster PDF export; stealth builds retain all of those surfaces while adding the wreq/BoringSSL transport and browser-identity protections.

Quickstart

Guides

Reference

Contributing

Links

License: Apache-2.0.