Obscura is an open-source headless browser engine built in Rust, designed for AI agent automation and large-scale web scraping. It offers a lightweight, fast, and stealthy alternative to traditional headless Chrome, providing significant advantages in memory usage, binary size, and performance. The project targets developers and organizations needing efficient and robust browser automation capabilities without the overhead of full browser installations.

How It Works

Obscura leverages the V8 JavaScript engine for real-time script execution and implements the Chrome DevTools Protocol (CDP), making it a drop-in replacement for tools like Puppeteer and Playwright. Its core architecture, written in Rust, prioritizes efficiency and minimal resource consumption. Key advantages include instant startup times, significantly faster page loads, and built-in anti-detection mechanisms, which are crucial for sophisticated scraping and AI agent interactions at scale.

Quick Start & Requirements

• Installation: Download pre-compiled binaries for Linux (x86_64), macOS (Apple Silicon/Intel), or Windows from the releases page. Alternatively, use yay -S obscura-browser on Arch Linux, or docker run -d --name obscura -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura. Building from source requires Rust 1.75+ (cargo build --release).
• Prerequisites: Rust 1.75+ for source builds. Docker image is available.
• Links: Releases: https://github.com/h4ckf0r0day/obscura/releases
• Setup Time: ~5 minutes for the initial build from source due to V8 compilation.

Highlighted Details

• Performance: Offers drastically reduced memory footprint (30 MB vs 200+ MB) and binary size (70 MB vs 300+ MB) compared to headless Chrome. Page load times are approximately 85 ms versus ~500 ms, with instant startup.
• Stealth Mode: Includes built-in anti-fingerprinting (randomized GPU, screen, canvas, audio, battery details) and tracker blocking (3,520 domains) for realistic browser emulation.
• CDP Compatibility: Fully implements the Chrome DevTools Protocol, enabling seamless integration with Puppeteer and Playwright.
• AI Agent Integration: Features an MCP (Model Context Protocol) server, allowing direct integration with AI agents like Claude Desktop and Cursor for browser automation tasks.

Maintenance & Community

The project is actively developed, with plans for a hosted "Obscura Cloud" version. The open-source engine remains fully featured under the Apache 2.0 license. No specific community channels (e.g., Discord, Slack) are detailed in the provided README.

Licensing & Compatibility

Licensed under Apache 2.0, permitting commercial use and integration into closed-source projects without copyleft restrictions.

Limitations & Caveats

Linux release builds are targeted at Ubuntu 22.04 (glibc 2.35+), potentially requiring compatibility checks on other distributions. Building from source necessitates a recent Rust toolchain (1.75+).