hyperbolictonic/hyperbolic-gateway

## The Local Web Browser for Your AI Agents
> "I'll hack the Gibson"
> — Dade Murphy (AKA Crash Override), Circa 1995
## 🧭 Index
About — What it is · A punk-ethos alternative to browser clouds
The deck — Theme & Cyberdeck UI · Ghost cursor telemetry · Focus-independent input · Multi-tab browsing
Reading the web — Orthogonal primitive layer · Construct harvester · Set-of-Marks
Driving the web — Shield-breaker · Form filler · Human-in-the-loop
Memory & data — Cortex · Downloads · Session vault · Script vault · Timelapse recorder
Inspection — Network & API streams · WebSocket & SSE
Operating it — System tray · MCP tools (63 advertised) · REST wrappers
Building on it — Architecture lowdown · Codebase & docs · Quickstart · Testing · OKF knowledge
Optional decision layer — decide / drive design notes · Control layer: targeting, consent, human takeover · Shadow DOM & iframes: what Hyperbolic Gateway can see and click · Shadow Walk: sealed-content plan · Field notes from dogfooding · Changelog
Release notes — What shipped · All releases
Lore — Neuromancer inspiration
## 🕶️ What it is
Hyperbolic Gateway is a visible, stateful web browser that any MCP agent can drive.
Most agent browsers are a library you integrate, or a cloud you rent. Hyperbolic Gateway is a desktop application you
own: a real Chromium window on your machine, controlled over the Model Context Protocol. Your agent runs
where you already run it — local or remote — and Hyperbolic Gateway supplies the browser, the input, and the memory.
A real browser, not a simulation. Visible Chromium with hardware acceleration, persistent cookies,
real tabs, downloads, and a human-sized viewport. No headless fingerprint.
Structured first, pixels when needed. observe returns a compact, addressable view of the page
(markdown, text, accessibility tree, or Set-of-Marks). takescreenshot is there when layout matters.
Input that looks human. Clicks and keys travel over the Chrome DevTools Protocol with Bézier paths
and Gaussian typing cadence — and they land even when another application owns the foreground.
State that survives. LanceDB memory, bookmark and session vaults, download harvesting and a script
vault mean the next session starts where the last one stopped.
Self-hosted by construction. stdio MCP plus a localhost bridge. No account, no dashboard, and no
telemetry leaving the machine.
Open the MP4 if your browser does not animate WebP.
> [!WARNING]
> EXPERIMENTAL PROTOTYPE: Hyperbolic Gateway is currently under active, experimental development. Tool contracts, telemetry tuning, and database schemas may evolve rapidly. Built for developers experimenting with multimodal local AI agents.
> [!IMPORTANT]
> RESEARCH PURPOSES ONLY: This software is provided strictly for educational, testing, and local AI agent research purposes. It is not intended for malicious use, automated credential stuffing, unauthorized exploitation, or violating third-party websites' Terms of Service. Users are responsible for complying with all applicable laws and terms.
Installers: grab them from Releases — Windows Setup/Portable/zip, macOS dmg/zip (x64 + arm64), Linux AppImage/deb/tar.gz. macOS is unsigned for now: right-click → Open (or xattr -dr com.apple.quarantine "/Applications/Hyperbolic Gateway.app"). Built by GitHub Actions; see docs/BUILDING.md.