R
roedyrustam/realmaya
AI-native headless browser automation library & MCP v1.x server (Chrome CDP & Firefox WebDriver BiDi) with…
updated 2026-11-17
View on GitHub ↗Direct link · no redirect page
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 0 ★ · roedyrustam/realmaya · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 2 sources
- Score
- score 203 · 2 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Browser automation. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
roedyrustam/realmaya;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# realmaya
Excerpted from the repository README (abridged)
realmaya is an AI-native headless browser automation library and native Model Context Protocol (MCP v1.x) server for controlling Chrome (CDP) and Firefox (WebDriver BiDi) with zero heavy driver dependencies.
It replaces brittle CSS/XPath-only automation and 50,000-token raw HTML dumps with an in-page Token-Compressed Semantic Distiller, Self-Healing Locator Cache, Speculative Parallel Branching (page.fork()), Set-of-Mark Visual Grounding, and a Prompt-Injection Firewall.
## Key Capabilities
| Capability | Description |
| Dual-Engine Headless Control | Zero-driver headless Chrome (CDP) and Firefox (native WebDriver BiDi) over a unified JSON-RPC WebSocket multiplexer. |
| Token-Compressed Semantic Distiller | Compresses 50k+ token DOMs (including open Shadow DOM) into semantic trees in = 85% token reduction). |
| Self-Healing Locator Cache | Repeat page.act() calls resolve in breakout tags, and prompt-injection override phrases; enforces onDestructiveAction confirmation hooks. |
| Set-of-Mark Visual Grounding & Network Mocking | Annotate interactive elements with [id] bounding-box overlays (page.screenshot({ setOfMark: true })) and mock fetch/XMLHttpRequest routes deterministically (page.mockRoute()). |
## Quick Start (TypeScript SDK)
ts
import { launch, createOpenAiCompatibleProvider } from 'realmaya';
import { z } from 'zod';
const llm = createOpenAiCompatibleProvider({
baseUrl: 'https://api.openai.com/v1',
apiKey: process.env.OPENAI_API_KEY,
model: 'gpt-4o-mini',
});
await using browser = await launch({
engine: 'chrome',
headless: true,
llm,
cachePath: '.realmaya/locators.db', // Supports .db/.sqlite (node:sqlite) or .json
onDestructiveAction: async ({ instruction, action }) => {
console.warn(Confirm destructive ${action}: ${instruction});
return false; // Block unapproved destructive actions
},
});
const page = await browser.newPage();
await page.goto('https://example.com');
// 1. Observe token-compressed semantic tree ( semantic tree |
| browser_act | Execute natural-language intent (click, type, select, press, scroll) via cache or MCP Sampling |
| browser_extract | Extract structured JSON from the current page matching requested field descriptions |
| browser_click | Deterministically click by numeric [id] or CSS selector |
| browser_type | Deterministically type into an input/textarea by [id] or CSS selector |
| browser_select | Select an in a element by [id] or CSS selector |
| browser_press | Dispatch keyboard key press (Enter, Escape, Tab, etc.) on an element |
It replaces brittle CSS/XPath-only automation and 50,000-token raw HTML dumps with an in-page Token-Compressed Semantic Distiller, Self-Healing Locator Cache, Speculative Parallel Branching (page.fork()), Set-of-Mark Visual Grounding, and a Prompt-Injection Firewall.
## Key Capabilities
| Capability | Description |
| Dual-Engine Headless Control | Zero-driver headless Chrome (CDP) and Firefox (native WebDriver BiDi) over a unified JSON-RPC WebSocket multiplexer. |
| Token-Compressed Semantic Distiller | Compresses 50k+ token DOMs (including open Shadow DOM) into semantic trees in = 85% token reduction). |
| Self-Healing Locator Cache | Repeat page.act() calls resolve in breakout tags, and prompt-injection override phrases; enforces onDestructiveAction confirmation hooks. |
| Set-of-Mark Visual Grounding & Network Mocking | Annotate interactive elements with [id] bounding-box overlays (page.screenshot({ setOfMark: true })) and mock fetch/XMLHttpRequest routes deterministically (page.mockRoute()). |
## Quick Start (TypeScript SDK)
ts
import { launch, createOpenAiCompatibleProvider } from 'realmaya';
import { z } from 'zod';
const llm = createOpenAiCompatibleProvider({
baseUrl: 'https://api.openai.com/v1',
apiKey: process.env.OPENAI_API_KEY,
model: 'gpt-4o-mini',
});
await using browser = await launch({
engine: 'chrome',
headless: true,
llm,
cachePath: '.realmaya/locators.db', // Supports .db/.sqlite (node:sqlite) or .json
onDestructiveAction: async ({ instruction, action }) => {
console.warn(Confirm destructive ${action}: ${instruction});
return false; // Block unapproved destructive actions
},
});
const page = await browser.newPage();
await page.goto('https://example.com');
// 1. Observe token-compressed semantic tree ( semantic tree |
| browser_act | Execute natural-language intent (click, type, select, press, scroll) via cache or MCP Sampling |
| browser_extract | Extract structured JSON from the current page matching requested field descriptions |
| browser_click | Deterministically click by numeric [id] or CSS selector |
| browser_type | Deterministically type into an input/textarea by [id] or CSS selector |
| browser_select | Select an in a element by [id] or CSS selector |
| browser_press | Dispatch keyboard key press (Enter, Escape, Tab, etc.) on an element |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/roedyrustam-realmaya/)
- Source
- github · https://github.com/roedyrustam/realmaya
- Browse by field
- Browser automation
- Listed by
- 2 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.