Plasmate Documentation
Plasmate is an open-source, agent-native headless browser engine written in Rust.
It compiles HTML into a Semantic Object Model (SOM) - a structured, token-efficient representation that AI agents can reason about directly. It replaces CDP with a purpose-built Agent Web Protocol (AWP).
Quick Links
| Document | Description |
|---|---|
| Quick Start | Install Plasmate and run your first fetch in 60 seconds |
| Product Spec | Full architecture, market analysis, and technical vision |
| AWP Protocol | Agent Web Protocol draft specification |
| AWP MVP v0.1 | The 7-method subset shipped in v0.1 |
| SOM Reference | Semantic Object Model structure and element addressing |
| Roadmap | Release history and what's next |
| Brand Guide | Colors, typography, voice, and the pixie dust system |
Key Numbers
- 4-5 ms per page throughput (100-page local benchmark, 231KB average)
- 9.4x median compression across 38 sites (HTML to SOM token reduction)
- 28 MB RSS memory per process
- 45.8 MB single binary (default) / 54 MB with plugins
- 200+ tests passing
- Apache 2.0 license
Architecture at a Glance
Agent (Python/JS/Rust)
|
|-- AWP (native, 7 methods)
|-- CDP (legacy compatibility)
|
Plasmate Engine
|-- HTML Parser (html5ever)
|-- SOM Compiler (regions, elements, budgets)
|-- V8 JS Runtime (script execution, DOM shim)
|-- Network Layer (reqwest, connection pooling, HTTP/2, request interception)
|-- TLS Configuration (cipher suites, fingerprint tuning)
|-- Session Manager (multi-page, 50 concurrent, encrypted auth profiles)
|-- Wasm Plugin System (optional, wasmtime runtime)
Source
- GitHub: plasmate-labs/plasmate
- License: Apache 2.0
- Website: plasmate.app