BrowserTrace v0.1.20

BrowserTrace v0.1.20 packages the compare JSON API for Browser Use failure debugging.

Highlights:

• Adds GET /api/compare/<failed_run_id>/<success_run_id> so local tools, wrappers, and agents can fetch the same first-divergence payload as browsertrace compare --json while the web UI is running.
• Keeps the Browser Use-first failure replay story: local timelines with screenshots, URL, action, model I/O, status, error, and public-safe HTML exports.
• Includes wheel, sdist, full demo export, public-safe demo export, demo video, poster, GIF, and social preview assets.

Install from PyPI:

pip install "browsertrace[ui]"
browsertrace doctor
browsertrace demo
browsertrace compare <failed_run_id> <success_run_id> --json

No-install PyPI trial:

uvx --from "browsertrace[ui]" browsertrace demo

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.19

BrowserTrace v0.1.19 is a Browser Use compare CLI release, centered on a concrete failure story: Browser Use tries to upload file:///tmp/browsertrace-report.html, navigates to the local file path instead, and the upload preview never appears.

Highlights:

• Adds browsertrace compare <failed_run_id> <success_run_id> to locate the first divergent action, URL, status, or error between two recorded runs.
• Documents the compare-run workflow in the Browser Use guide, README, and examples command cheat sheet.
• Keeps the Browser Use-first PyPI package, deterministic no-API demo, and public-safe export assets for quick inspection.

Install from PyPI:

pip install "browsertrace[ui]"
browsertrace doctor
browsertrace demo
browsertrace compare <failed_run_id> <success_run_id>

No-install PyPI trial:

uvx --from "browsertrace[ui]" browsertrace demo

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.18

BrowserTrace v0.1.18 is a metadata and launch-surface patch release for the Browser Use-first positioning.\n\nHighlights:\n\n- Refreshes the packaged README and PyPI long description around replaying failed Browser Use runs locally.\n- Updates package metadata and launch copy to point at v0.1.18.\n- Keeps the deterministic no-API demo and public-safe export assets for quick inspection.\n\nInstall from PyPI after publish:\n\nbash\npip install "browsertrace[ui]"\nbrowsertrace doctor\nbrowsertrace demo\nbrowsertrace\n\n\nNo-install PyPI trial after publish:\n\nbash\nuvx --from "browsertrace[ui]" browsertrace demo\n\n\nUse browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.17

BrowserTrace v0.1.17 packages the latest Stagehand evidence improvements and launch-surface cleanup.

Highlights:

• Adds compact stagehand_evidence summaries for Stagehand observe/action-shaped results, including selectors, descriptions, and methods when available.
• Keeps Stagehand optional and dependency-free in BrowserTrace tests.
• Improves standalone HTML exports with responsive viewport metadata and narrow-screen layout.
• Keeps the deterministic no-API demo and public-safe export assets for quick inspection.

Install from PyPI:

pip install "browsertrace[ui]"
browsertrace doctor
browsertrace demo
browsertrace

No-install PyPI trial:

uvx --from "browsertrace[ui]" browsertrace demo

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.16

BrowserTrace v0.1.16 completes the PyPI launch cleanup.\n\nHighlights:\n\n- BrowserTrace is now published on PyPI with Trusted Publishing.\n- README, launch copy, PyPI metadata, llms.txt, and guide quickstarts now use the public PyPI install path.\n- browsertrace doctor now points missing UI dependency guidance to pip install "browsertrace[ui]".\n- The release keeps the deterministic no-API demo and public-safe export assets for quick inspection.\n\nTry from PyPI:\n\nbash\npip install "browsertrace[ui]"\nbrowsertrace doctor\nbrowsertrace demo\nbrowsertrace\n\n\nNo-install PyPI trial:\n\nbash\nuvx --from "browsertrace[ui]" browsertrace demo\n\n\nUse browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.15

Note: PyPI publishing is now live. For the current packaged release, use BrowserTrace v0.1.17 and install with:

pip install "browsertrace[ui]"

Current release: https://github.com/aaronlab/browsertrace/releases/tag/v0.1.17
PyPI: https://pypi.org/project/browsertrace/

---

BrowserTrace v0.1.15 adds a Browser Use run-hook helper while PyPI publishing is still waiting on owner-side Trusted Publisher setup.

Highlights:

• Added create_run_hooks for Browser Use apps that pass on_step_start and on_step_end directly to agent.run(...).
• The run-hook helper records Browser Use history and browser-session summaries when available: latest thought, action, extracted content, URL, title, tabs, and screenshot flag.
• Kept the existing attach_tracer(agent, ...) path for Browser Use agents that expose register_new_step_callback or compatible callback attributes.
• Refreshed README, Browser Use guide, launch kit, llms.txt, and release links to the pinned v0.1.15 tag.

Try before PyPI:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.15" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.15" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.15" browsertrace

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.14

BrowserTrace v0.1.14 packages the latest Browser Use and Stagehand integration improvements while PyPI publishing is still waiting on owner-side Trusted Publisher setup.

Highlights:

• Browser Use adapter now records compact browser-state context in model_input, including step count, URL, title, tabs, and whether a screenshot was captured.
• Browser Use guide now documents callback compatibility and troubleshooting paths for callback-style and run-hook-only apps.
• Stagehand wrapper now records successful act, extract, observe, goto, and click return values as step model_output.
• PR template and security reporting docs were clarified for safer contributor onboarding.

Try before PyPI:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.14" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.14" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.14" browsertrace

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.13

BrowserTrace v0.1.13 is a launch-readiness patch for first-run onboarding.\n\n- Fixes browsertrace doctor so missing UI dependency guidance points to the current GitHub release-tag install path while PyPI publishing is still pending.\n- Adds README troubleshooting notes for common first-run doctor states such as Database: missing and Runs: 0.\n- Updates README, launch packets, guides, llms.txt, and owner-action docs to use v0.1.13.\n\nTry it before PyPI is enabled:\n\nbash\nuvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor\nuvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo\nuvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace\n\n\nLive demo: https://aaronlab.github.io/browsertrace/\nPublic-safe export: https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo-public.html\nLaunch discussion: #6

BrowserTrace v0.1.12

BrowserTrace v0.1.12 aligns the GitHub tag install path with the latest launch docs, computer-use guide, and runnable examples.

Highlights:

• Added a custom computer-use debugging guide for generic observe-decide-act browser-agent loops.
• Added examples/computer_use_loop_example.py, a no-browser/no-API example for custom computer-use agents.
• Added copy buttons to the core guide quickstarts so users can run the GitHub tag demo with less manual selection.
• Updated GitHub install and uvx launch copy to point at v0.1.12.

Useful links:

• Live demo: https://aaronlab.github.io/browsertrace/
• Computer-use guide: https://aaronlab.github.io/browsertrace/computer-use-agent-debugging.html
• Debugging walkthrough: https://aaronlab.github.io/browsertrace/debug-browser-agent-failure.html
• Public-safe demo export: https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo-public.html
• Good first issue: #23
• Public-safe export docs issue: #25
• Launch discussion: #6

Try without PyPI while Trusted Publisher setup is still pending:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace list
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace

Release assets include the wheel, sdist, full demo HTML export, public-safe demo export, demo video, poster, and GIF.

BrowserTrace v0.1.11

BrowserTrace v0.1.11 adds a first-run diagnostic command for lower-friction launch testing.

Highlights:

• Added browsertrace doctor to print Python version, BrowserTrace home, database status, run/step counts, UI dependency availability, and the next command to run.
• doctor works even before a trace database exists, so new users can verify their install before running the demo.
• Updated GitHub install and uvx launch copy to point at v0.1.11.

Try without PyPI while Trusted Publisher setup is still pending:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace list
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace

Release assets include the wheel, sdist, full demo HTML export, public-safe demo export, demo video, poster, and GIF.