# Continuous Benchmarking with Airspeed-Velocity and CIGR
###### tags: `how-to`, `instructional`, `benchmarking`, `cigr`

Or how to run your benchmarks continously on daint and publish the benchmarking history via github-pages.

The documentation for the `asv` package can be found here: https://asv.readthedocs.io/en/stable/index.html.

## Running Benchmarks with Airspeed-velocity

- [X] develop or connect existing benchmarks with `asv`
- [X] manually keep history
- [X] manually publish to gh-pages
- [ ] run continuously or manually via gitlab-ci on daint
- [ ] keep history from CI runs
- [ ] publish from CI runs to gh-pages
- [ ] keep history and webinterface on a separate repository

The general rule with `asv` is that the `asv` commandline tool probably has a subcommand that helps.
In this case this is the `quickstart`, which sets up a reasonable starting config in the top level of your repository. Then you will have to point the config to the python module(s) that implement the classes that `asv` will use as entry points. The whole process is documented at the following link:
https://asv.readthedocs.io/en/stable/using.html.

The link also explains how to run the benchmarks, how to keep track of which run happend on what kind of machine and how to publish the entire history (manually) on gh-pages, all with a very user-friendly CLI.

##