Skip to content

Reading the repo

Opening the box…

How to install obscura on macOS (h4ckf0r0day/obscura) · gitmanual

How to install on macOS

h4ckf0r0day/obscura

The headless browser for AI agents and web scraping

Rust#antidetect#antidetect-browser#browser#browser-automation

Difficulty: Easy
Time: about 5 min
Stars: ★ 30,933
Activity: Updated this month

Before you start

Is it free?: YesOpen source (Apache-2.0).
Still maintained?: Yes, activeLast change today. Latest release v0.2.6, 9 days ago.
Can I trust it?: Some track record31k stars, 7 months old. Get it from the official repo and read what it installs.

Saved setup from 9 h ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗obscura.shThe project's own site.

Download for macOS

v0.2.6 · 10/31/2026 ↗

obscura-aarch64-macos.tar.gz

tar.gz · Apple Silicon · 67.3 MB · 889 downloads · best match

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-aarch64-macos.tar.gz"
tar -xzf "obscura-aarch64-macos.tar.gz"

Other macOS downloads (7)

obscura-aarch64-macos-no-render-stealth.tar.gz

tar.gz · Apple Silicon · 42.5 MB · 188 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-aarch64-macos-no-render-stealth.tar.gz"
tar -xzf "obscura-aarch64-macos-no-render-stealth.tar.gz"

obscura-aarch64-macos-no-render.tar.gz

tar.gz · Apple Silicon · 39.4 MB · 34 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-aarch64-macos-no-render.tar.gz"
tar -xzf "obscura-aarch64-macos-no-render.tar.gz"

obscura-aarch64-macos-stealth.tar.gz

tar.gz · Apple Silicon · 70.4 MB · 336 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-aarch64-macos-stealth.tar.gz"
tar -xzf "obscura-aarch64-macos-stealth.tar.gz"

obscura-x86_64-macos-no-render-stealth.tar.gz

tar.gz · Intel · 44.9 MB · 16 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-x86_64-macos-no-render-stealth.tar.gz"
tar -xzf "obscura-x86_64-macos-no-render-stealth.tar.gz"

obscura-x86_64-macos-no-render.tar.gz

tar.gz · Intel · 41.5 MB · 14 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-x86_64-macos-no-render.tar.gz"
tar -xzf "obscura-x86_64-macos-no-render.tar.gz"

obscura-x86_64-macos-stealth.tar.gz

tar.gz · Intel · 72.9 MB · 47 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-x86_64-macos-stealth.tar.gz"
tar -xzf "obscura-x86_64-macos-stealth.tar.gz"

obscura-x86_64-macos.tar.gz

tar.gz · Intel · 69.6 MB · 124 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.6/obscura-x86_64-macos.tar.gz"
tar -xzf "obscura-x86_64-macos.tar.gz"

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker run -d --name obscura -p 127.0.0.1:9222:9222  -e OBSCURA_CDP_TOKEN  h4ckf0r0day/obscura

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Rust stableruntime

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/h4ckf0r0day/obscura/badge.svg)](https://gitmanual.com/h4ckf0r0day/obscura)

Good to know

Cargo workspace — pick a crate with cargo run -p <name>.
Dockerfile available (base image: rust:1-slim-bookworm).
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: crates/obscura-browser/Cargo.toml, crates/obscura-cdp/Cargo.toml, crates/obscura-cli/Cargo.toml, crates/obscura-dom/Cargo.toml and 9 more

Details

License: Apache-2.0
Open issues: 212
Branch: main

Files we read (7)

.github/workflows/ci.yml

.github/workflows/docker.yml

.github/workflows/release.yml

Cargo.toml

Dockerfile

README.md

docs/Installation.md

520 files in the repo