asv-tachyon

Modern web UI for airspeed velocity results.

ASV’s built-in site is still jQuery + Flot + Bootstrap 3. asv-tachyon is a drop-in shell over the same static data that asv publish already writes (index.json, graphs/**, regressions.json). No server-side app, no new result format, no second benchmark type.

Overview — sparkline tiles over published ASV graphs

Gallery

Compare (spyglass-style ratios)	Inventory (SBOM-style env lock)
Env or revision pairs · Before / After / Ratio · factor gate	added · removed · version-bumped · drop result JSON files

Install

pip install asv-tachyon
# or from a checkout after building the UI once
cd web && npm install && npm run build && cd ..
pip install -e .

Usage

asv run
asv publish
asv-tachyon serve .asv/html --open

Or replace the legacy index.html in place (keeps all graph JSON):

asv publish
asv-tachyon install .asv/html
asv-tachyon serve .asv/html

Demo without a project:

asv-tachyon serve fixtures/sample_site --open

What you get

• Overview — fluid sparkline atlas, search, light/dark themes
• Explore — full uPlot series, param multi-series overlays with stable colors, filters preserved across benchmark switches (URL hash shareable)
• Compare — multi-env compare-many columns from graph_param_list, or revision pairs (same factor semantics as asv compare / asv-spyglass)
• Regressions — regressions.json table with interactive factor threshold
• Inventory — SBOM-style env lock diffs (added / removed / version-bumped) over published params + machines, or by dropping two raw result JSON files
• Self-hosted fonts (offline-safe; no Google Fonts CDN)
• Same data contract as the stock ASV site — see docs/source/data-contract.rst for index.json + graphs/** + regressions.json shapes (adapters / pytest-benchmark exporters)

Development

# terminal 1: static data
asv-tachyon serve fixtures/sample_site -p 8765

# terminal 2: vite (optional hot reload)
cd web && npm install && npm run dev

Docs site (Sphinx + Shibuya):

pip install -e '.[docs]'
sphinx-build -b html docs/source docs/build/html

License

MIT.