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 — virtualized sparkline atlas, type/machine filter chips with counts, only-regressed filter, light/dark themes
• Explore — uPlot with CI bands, brush zoom, dual-cursor delta, tag markers, commit tooltips (commits.json), distribution violin/strip when samples exist, Report subview, multi-machine overlay, profile link (profiles.json)
• Heatmap — last-N revision ratios ("what regressed"); click opens Explore
• Grid — multi-param summary table at latest revision
• Multiples — small-multiples sparkline wall
• 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 factor threshold + mute list (localStorage key asv-tachyon-mute)
• Inventory — SBOM-style env lock diffs (added / removed / version-bumped)
• Copy deep link — copies location.href including hash filters
• Print / PDF — print CSS for Compare / Inventory / Explore
• Throughput / higher-is-better when type is track, unit contains ops, or less_is_better: false in benchmark meta
• 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

Optional sidecars (static)

Adapters

Import foreign benchmark JSON into a minimal ASV html tree:

python adapters/criterion_to_asv.py path/to/target/criterion -o asv_html
python adapters/pytest_benchmark_to_asv.py bench.json -o asv_html
asv-tachyon serve asv_html --open

CI template

See docs/workflows/asv-studio.yml for a commented GitHub Actions outline: asv publish → asv-tachyon install → Pages; PR path with asv-perch / asv-spyglass; local spyglass recipe.

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.