Generative Agent Test Protocol — one install, any agent, any LLM, 10× fewer tokens.
Every AI agent that touches the web today is duct-taped together from six different vendors — a browser driver, a perception layer, a stealth proxy, a captcha solver, an auth manager, a benchmark harness — and burns ~2 million tokens to do what a human does in 30 seconds.
We think that's nuts.
genATP is one install that replaces the whole stack — and adds the two things nothing else has: deterministic, self-healing Action Cassettes that replay with zero LLM calls, and a declarative ATP Spec that doubles as test, automation, and production agent tool.
The web speaks human. Agents speak structured data. We're the translator everybody else forgot to build.
|
Real numbers
Self-hosted. Source-available. Written in Rust. |
- A web-access tool that needs six vendors is broken. It should be one install.
- Tokens are a real cost. Every snapshot, every prompt, every retry — measured, compressed, justified.
- Workflows shouldn't pay the LLM tax twice. Record once, replay forever.
- Determinism is a feature. Agents that drift silently are worse than agents that fail loudly.
- The same spec should run as a test, an automation, and an agent tool. Three formats for one workflow is two too many.
- Source-available beats closed-source for trust, and trust beats marketing.
# Pick your flavor
pip install genatp # Python
npm install genatp # TypeScript / Node
brew install genatp # CLI on macOS
genatp init # one-time setupThen point your agent — Claude Desktop, Cursor, LangChain, your own — at the MCP server, SDK, or HTTP endpoint. Full quickstart in the project README.
| Tag | Milestone |
|---|---|
| v0.1 | MCP server + token-optimized snapshots — first public release |
| v0.3 | Encrypted Auth Vault |
| v0.5 | Action Cassettes (record + replay + self-heal) + ATP Spec |
| v0.6 | TypeScript SDK |
| v0.7 | Stealth engine + DOM ↔ vision auto-switch |
| v0.8 | Cassette Registry + time-travel debugger |
| v1.0 | GA — full WebVoyager benchmark (≥ 85% / ≤ 35k tokens) |
Full phased plan: docs/DEVELOPMENT_PLAN.md.
- ⭐ Star genatp/genatp — it genuinely helps
- 📖 Read the PRD before opening an issue — most "feature ideas" are already answered
- 🐛 File an issue with a failing repro for bugs, with a use case for proposals
- 🤝 Open a PR — see
CONTRIBUTING.md - 🔐 Report a security issue privately — see
SECURITY.md
The web speaks human. Agents speak structured data. genATP is the translator everybody else forgot to build.
Flagship repo · Docs · Roadmap