#shogi #usi #sfen

app usi-run

A command line utility for running games between USI compliant Shogi engines

12 releases (breaking)

0.9.0 Oct 3, 2021
0.8.0 Nov 14, 2020
0.7.0 Jan 1, 2020
0.6.0 Jan 27, 2019
0.2.2 Mar 5, 2017

#756 in Command line utilities

41 downloads per month

MIT license

43KB
1K SLoC

usi-run

Github Actions Coverage Status crates.io

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  [default: simple]  [values: board, csa, command, simple]

A configuration file looks like the following. See example.toml for more detail.

num_games = 10
max_ply = 256

[time_control]
black_time = 60000
white_time = 60000
black_inc = 10000
white_inc = 10000

[black]
engine_path = "/path/to/executable"
working_dir = "/path/to/dir"
ponder = false

    [black.options]
    USI_Hash = 128
    Threads = 1

[white]
engine_path = "/path/to/executable"
working_dir = "/path/to/dir"
ponder = false

    [white.options]
    USI_Hash = 128
    Threads = 1

Dependencies

~7.5MB
~160K SLoC