librosa-benchmarks

ASV benchmark suite and GitHub Pages publishing for tracking performance of librosa.

What this repository does

• Runs benchmarks on a weekly schedule (and manually on demand).
• Uses audio data from librosa/data by cloning it once in CI.
• Publishes benchmark results and trend charts to GitHub Pages (gh-pages).

Notes on JIT startup costs

Some librosa paths hit JIT-compiled internals. Benchmarks explicitly do a warmup call in setup() so startup compile cost is excluded from timed runs.

Repository layout

• asv.conf.json — ASV configuration
• benchmarks/ — benchmark definitions
• scripts/fetch_data.py — clone/update librosa/data
• .github/workflows/benchmark.yml — weekly benchmark execution
• .github/workflows/publish.yml — site publish to gh-pages

Local usage

python -m pip install -r requirements.txt
python scripts/fetch_data.py
asv machine --yes
asv run --config asv.conf.json --python=same --show-stderr
asv publish --config asv.conf.json
asv preview --config asv.conf.json