usi-run

A command line utility for automatically running games between USI compliant Shogi engines and collect match statistics.

Tested with popular USI engines, e.g. Apery, Gikou(技巧), YaneuraOu(やねうら王).

Installing

usi-run can be installed from Cargo.

$ cargo install usi-run

Usage

A command line utility for running games between USI compliant Shogi engines. │ │ USAGE: │ usirun [OPTIONS] --config <TOML> │ │ FLAGS: │ -h, --help Prints help information │ -V, --version Prints version information │ │ OPTIONS: │ -c, --config <TOML> Loads a configuration file for setting up match rules │ -d, --display <MODE> Displays [values: board, command, simple]

A configuration file looks like the following. See example.toml for more detail. ``` [match] numgames = 10 maxply = 256

[timecontrol] blacktime = 60000 whitetime = 60000 blackinc = 10000 white_inc = 10000

[black] enginepath = "/path/to/executable" workingdir = "/path/to/dir" ponder = false

[black.options]
USI_Hash = 128
Threads = 1

[white] enginepath = "/path/to/executable" workingdir = "/path/to/dir" ponder = false

[white.options]
USI_Hash = 128
Threads = 1

```