taprun
Compile your AI agent's browser-acting trajectory into a deterministic program that replays at zero LLM tokens, with built-in drift verification.
pip install taprun
After install you get two surfaces in one package:
1 · CLI
The tap command. First invocation downloads the platform binary from
the npm @taprun/cli-* packages; subsequent calls exec the cached
binary. Equivalent to brew install LeonTing1010/tap/taprun for Python
users on Linux/Windows where Homebrew isn't standard.
tap forge https://news.ycombinator.com/ # compile a tap (Tier 0, no AI)
tap run hackernews/top # zero LLM tokens
tap doctor hackernews/top # cross-validate vs authoritative
tap mcp start # MCP server for Claude Code / Cursor / Cline
2 · Python SDK
from taprun import forge, run, doctor. Each call shells out to the
same tap CLI; ~30-100 ms warm spawn cost. For hot loops use
tap mcp start and call via MCP instead.
from taprun import run, doctor
rows = run("hackernews/top") # execute a compiled tap
print(rows[0]["title"])
verdict = doctor("hackernews/top") # 'ok' / 'broken' / 'stale'
Compile from a browser-use trajectory
from browser_use import Agent
from taprun import forge
agent = Agent(task="...", llm=...)
result = await agent.run()
forge(
trajectory=result.model_dump(), # AgentHistoryList dict, JSON string, or path
site="example",
name="dashboard",
)
# writes ~/.tap/taps/example/dashboard.tap.json
# replay with: tap run example/dashboard
v1 trajectory compile covers the navigation skeleton (go_to_url,
click_element, input_text, scroll, wait, done). Navigation
steps replay at 0 LLM tokens. For destination pages exposing a Tier 0
source (RSS / JSON-LD / agents.json / OpenAPI), pair with tap forge <url> to compile the extraction half — that combination delivers
end-to-end zero-token replay. Stagehand and raw Anthropic tool-use
formats land in a follow-up.
How it works
- Forge: inspect the site → compile a deterministic
.tap.jsonplan (one-time cost; free for pages with a Layer 1 source). - Run: replay the plan, no LLM in the loop.
- Doctor: independently fetch the authoritative source and diff. Catches drift the agent would miss on a self-replay.
- Heal: cached patches replay at 0 tokens; LLM only invoked when the patch cache misses (Pro tier).
Configuration
# Override the binary path (e.g. to use a brew-installed `tap`)
export TAPRUN_BIN=/opt/homebrew/bin/tap
# AI key for the forge pipeline (BYOK; Hacker tier and above)
tap config set ai.key sk-ant-...
Pricing
- Free: 65+ community taps, run, doctor, Tier 0 forge (the deterministic compile path when Layer 1 is available).
- Hacker ($9/mo, BYOK): full forge pipeline with Layer 4 AI fallback.
- Pro ($29/mo): heal + refresh + scheduling. 100% local.
The MCP server / CLI / forge / doctor binary is closed-source. The public Chrome extension runtime (https://github.com/LeonTing1010/tap) is MIT.
Links
- Homepage: https://taprun.dev/?utm_source=pypi&utm_medium=package&utm_campaign=taprun
- Docs: https://taprun.dev/docs?utm_source=pypi&utm_medium=package&utm_campaign=taprun-docs
- Issues: https://github.com/LeonTing1010/tap/issues
- Skills: https://github.com/LeonTing1010/tap-skills
MIT License (the public extension; the tap binary distributed by this
package is proprietary).
1 maintainer
Release files for taprun 0.30.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| taprun-0.30.0.tar.gz | 9.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| taprun-0.30.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.5 kB
Release files / taprun-0.30.0.tar.gz
| Download URL | taprun-0.30.0.tar.gz |
|---|---|
| Size | 9.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
620d429db0ea52aa257d045785c050983be12008bda7d2971b61a304c5c88ae5
|
|
BLAKE2b-256 checksum How to use checksums |
cd85487ce25a69ad152c99fea4569f7d2bcd903b44610de3880569488e288279
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / taprun-0.30.0-py3-none-any.whl
| Download URL | taprun-0.30.0-py3-none-any.whl |
|---|---|
| Size | 9.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eba363bf8fb35314f39a41574d4b3817cfaa6395189b0904c0ce4609315f11fd
|
|
BLAKE2b-256 checksum How to use checksums |
e55bd6f1d9f012d00b7ec16c9b77d9630ef2c75688fee087d58400f4da52f2bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
