# Agent Browser Runtime (ABR)

> Open-source (MIT), self-hostable runtime for stateful, secure browser-session execution: capture a user's authenticated browser session once, store it encrypted in your own database, and run unattended, verified Playwright jobs as that user. Version 0.1.1.

Author: Praveen Palanisamy (https://github.com/praveen-palanisamy)
Source: https://github.com/praveen-palanisamy/agent-browser-runtime
npm: https://www.npmjs.com/package/@praveen-palanisamy/agent-browser-runtime
Container: ghcr.io/praveen-palanisamy/agent-browser-runtime
GitHub Action: uses: praveen-palanisamy/agent-browser-runtime@v0

## Docs

- [README](https://praveen-palanisamy.github.io/agent-browser-runtime/docs/README.html): value proposition, quick start, contracts, runner API
- [Architecture](https://praveen-palanisamy.github.io/agent-browser-runtime/docs/ARCHITECTURE.html): contracts, lifecycle, verification model
- [Deploy](https://praveen-palanisamy.github.io/agent-browser-runtime/docs/DEPLOY.html): environment, providers, Docker/Cloud Run, distribution channels
- [GitHub Action](https://praveen-palanisamy.github.io/agent-browser-runtime/docs/GITHUB_ACTION.html): probes and jobs from CI
- [For agents](https://praveen-palanisamy.github.io/agent-browser-runtime/docs/AGENTS.html): notes for coding agents and LLM tool builders
- [Full text](https://praveen-palanisamy.github.io/agent-browser-runtime/llms-full.txt): all docs concatenated

## Key facts

- Contracts: SessionStore, SessionProvider, WebPostStrategy; AgentPostResult has ok, uncertain, needsReauth, failureStage, refreshedSession.
- Providers: local Chromium, any CDP endpoint, Steel (self-hosted/cloud, live view), Kernel microVMs.
- Runner HTTP API: POST /v1/post, /v1/probe, /v1/capture/start|finish|cancel, GET /healthz; bearer token auth.
- The runtime never persists sessions; the embedding application encrypts and stores them.
- Use only with the user's explicit authorization and within each site's terms of service.