whatisgithub

What is obscura?

h4ckf0r0day/obscura — explained in plain English

Analysis updated 2026-05-18

19,579RustAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A lightweight, Rust based headless browser built as a fast, stealthy alternative to headless Chrome for web scraping and AI agent automation.

Mindmap

mindmap
  root((Obscura))
    What it does
      Runs a headless browser
      Executes real JavaScript via V8
      Supports Chrome DevTools Protocol
    Tech stack
      Rust
      V8
      Puppeteer and Playwright compatible
    Use cases
      Automate web scraping
      Power AI agent browsing
      Replace headless Chrome in existing tools
    Audience
      Developers
      AI agent builders
      Data teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Replace headless Chrome in an existing Puppeteer or Playwright scraping setup for lower memory use.

USE CASE 2

Give an AI agent the ability to browse and interact with real web pages automatically.

USE CASE 3

Run large-scale web scraping jobs where fast startup and small binary size matter.

USE CASE 4

Use built-in anti-detection features to reduce the chance of automated traffic being blocked.

What is it built with?

RustV8Chrome DevTools ProtocolPuppeteerPlaywright

How does it compare?

h4ckf0r0day/obscuraogulcancelik/herdrbee-san/rustscan
Stars19,57919,42419,770
LanguageRustRustRust
Setup difficultymoderateeasyeasy
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Works as a drop-in replacement for headless Chrome, but responsible use requires respecting target sites' terms of service.

Apache-2.0 license: free to use, modify, and distribute, including commercially, with attribution and patent grant terms.

So what is it?

Obscura is a headless browser engine written in Rust, built for web scraping and for AI agents that need to interact with web pages automatically. A headless browser is one that renders and runs a web page without showing a visible window, which makes it useful for automated tasks. Obscura runs real JavaScript through the V8 engine, the same engine that powers Chrome, and supports the Chrome DevTools Protocol, which means it can act as a drop-in replacement for headless Chrome in tools like Puppeteer and Playwright that developers already use for browser automation. The project's main pitch is efficiency and stealth compared to running headless Chrome directly. According to the README, Obscura uses around 30 megabytes of memory versus over 200 for headless Chrome, has a smaller binary size, starts up almost instantly instead of taking a couple of seconds, and loads pages faster. It also includes built-in anti-detection features, meaning it is designed to look less like an automated bot to websites that try to block scrapers, something headless Chrome does not offer on its own. The open-source engine is licensed under Apache-2.0 and the project states that no features will ever be locked behind a paywall in this version. Separately, the team is building a paid hosted option called Obscura Cloud, which would provide managed infrastructure, residential proxies, and dedicated support for people who would rather not run and maintain the engine themselves. The project has attracted meaningful community traction, having recently crossed ten thousand stars on GitHub, and lists several commercial proxy service sponsors that support automation workflows built on top of it. Anyone considering Obscura should keep in mind that browser automation and anti-detection tooling can be used both for legitimate scraping and testing work and for activity that violates a website's terms of service, so it is worth using responsibly and within the bounds of the law and the sites you interact with.

Copy-paste prompts

Prompt 1
Explain how to swap Obscura in as a drop-in replacement for headless Chrome in my Puppeteer script.
Prompt 2
Walk me through setting up Obscura for an AI agent that needs to browse web pages.
Prompt 3
Compare Obscura's memory and startup performance claims against headless Chrome for my use case.
Prompt 4
Show me how Obscura's Chrome DevTools Protocol support works with Playwright.

Frequently asked questions

What is obscura?

A lightweight, Rust based headless browser built as a fast, stealthy alternative to headless Chrome for web scraping and AI agent automation.

What language is obscura written in?

Mainly Rust. The stack also includes Rust, V8, Chrome DevTools Protocol.

What license does obscura use?

Apache-2.0 license: free to use, modify, and distribute, including commercially, with attribution and patent grant terms.

How hard is obscura to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is obscura for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.