A tool for easy benchmarking and snapshot testing a UCI chess engine.
Use chess-bench to:
- Benchmark your engine
- Diff a benchmark against a stored snapshot (useful for comparing branches or different engines)
- Add CI tests that fail when non-functional changes don't match stored snapshots
run chess-bench --help for a list of options
Run chess-bench with the --all/-a flag to output all the available metrics
in a table. Pass the path to the engine you'd like to benchmark as the last
argument.
$ chess-bench -a simbelmyne
$ chess-bench -aS simbelmyne
$ chess-bench -a stockfish
When running chess-bench, pass the --save/-S flag to save the results
to bench_snapshot.json. The output file can be changed by passing the
--output/-o flag.
When running chess-bench in a directory that has a bench_snapshot.json file
present (or when passed a snapshot explicitly using --snapshot/-s),
the engine outputs a snapshot diff instead.
