@theaiinc/realm-browser

Playwright/Chromium browser engine for Realm.

Enables AI agents to interact with web pages through an automated browser — navigate, click, type, extract text, and capture screenshots — all behind the universal Realm API.

Features

• Headless Chromium — Full browser automation via Playwright
• Page interaction — Navigate, click, type, scroll, extract text
• Screenshot capture — Full-page and viewport screenshots
• Session isolation — Each realm gets its own browser context
• Network control — Restrict or allow internet access per session

Installation

pnpm add @theaiinc/realm-browser

Usage

import { BrowserEngine } from '@theaiinc/realm-browser';

const engine = new BrowserEngine();
const session = await engine.create({ headless: true });
await engine.navigate(session.id, 'https://example.com');
const text = await engine.getPageText(session.id);

Dependencies

• playwright — Browser automation framework

License

MIT