GLOBIS-AQZ

GLOBIS-AQZ is a Go game engine that uses Deep Learning technology.
It features support for both the Japanese rule with Komi 6.5 and the Chinese rule with Komi 7.5.

This program utilizes the results of the GLOBIS-AQZ project.

GLOBIS-AQZ is a joint project developed by GLOBIS Corporation, Mr. Yu Yamaguchi, and Tripleize Co., Ltd., provided by the National Institute of Advanced Industrial Science and Technology (AIST), and cooperated by the Nihon Ki-in. This program uses the result of GLOBIS-AQZ.

Since it is open source software, anyone can use it for free.
This program is for playing and analyzing games, so please set it to GUI software such as Lizzie, Sabaki and GoGui.

日本語の説明はこちらをご覧ください。
请看这里的中文解释.

1. Downloads

Download executable files from Releases.
The executable files built on Windows 10 or Linux (Ubuntu 18.04) are available.

If it does not work as it is in other environments, please consider building it for each environment. (for developers)

2. Requirements

OS : Windows 10, Linux (64-bit)
GPU : Nvidia's GPU (Compute Capability >3.0)
CUDA Toolkit 10.0 or 10.2 + cuDNN 7.6.5
TensorRT 7.0.0
Visual C++ redistributable packages for Visual Studio 2015-2019 (for Windows only)

It has been tested in the following environment.

Ubuntu 18.04 / RTX2080Ti / CUDA10.0 / TensorRT7.0.0
Windows 10 Pro (64bit) / RTX2080Ti / CUDA10.2 / TensorRT7.0.0

3. How to use

For example, if you want to start GTP mode in the case of Japanese rule and with time settings of 20 minutes and 30-seconds byoyomi:

$ AQ.exe --rule=1 --komi=6.5 --main_time=1200 --byoyomi=30

With Chinese rule and Komi 7.5 (default), the number of searches (playouts) is fixed at 800 without ponder:

$ AQ.exe --search_limit=800 --use_ponder=off

With Tromp-Taylor rule and Komi 7.5, 15 minutes sudden death such as games on CGOS:

$ AQ.exe --rule=2 --repetition_rule=2 --main_time=900 --byoyomi=0

3-1. Setting environment variables

In the case of Windows, the following path must be registered in the PATH environment variable.

{your_cuda_path}\NVIDIA GPU Computing Toolkit\CUDA\v10.{x}\bin
{your_tensorrt_path}\TensorRT-7.0.0.{xx}\lib

3-2. Generating engine files

The first time it starts up, it generates a network engine optimized for your environment from a file in UFF (Universal File Format) format.
It may take a few minutes to generate this engine.
The serialized engine files are saved in the engine folder, so it will start immediately the second time around.

3-3. Register with Lizzie

For Windows, add {your_aq_folder}/AQ.exe --lizzie to the engine command.
For example, if you want to analyze by Japanese rules, please modify the config.txt file in the AQ folder to use various settings.

4. Options

Here's a description of the main options.
It can be specified as a command line argument, or it can be changed by editing config.txt.
For example, --komi=6.5.

4-1. Game options

Option	default	description
--num_gpus	1	The number of GPUs to use.
--num_threads	16	The number of threads to be used for searching.
--main_time	0.0	Main time of search (in seconds).
--byoyomi	3.0	Byoyomi (in seconds).
--rule	0	The rule of the game. 0: Chinese rule 1: Japanese rule 2: Tromp-Taylor rule
--komi	7.5	Number of Komi. In the case of Japanese rule, please specify 6.5.
--batch_size	8	The number of batches for a single evaluation.
--search_limit	-1	The number of searches (playouts). -1 means this option is disable.
--node_size	65536	Maximum number of nodes of the search. When this number of nodes is reached, the search is terminated.
--use_ponder	on	Whether or not to read ahead in the opponent's turn. You must turn it on when using it in Lizzie.
--resign_value	0.05	the winning rate to be given up.
--save_log	off	Whether or not to save the game's thought logs and sgf files.

4-2. Launch modes

Mainly for debugging. Please do not use any other games other than --lizzie for normal games and analysis.
They are only recognized as a command line argument.

Option	Launch mode
(not specified)	GTP communication mode
--lizzie	In addition to GTP communication, it outputs information for Lizzie.
--self	AQ starts a self game.
--policy_self	AQ starts a self game with the best move in policy networks.
--test	Tests the consistency of the board data structure, etc.
--benchmark	Measures the computational speed of rollouts and neural networks.

5. Compilation method

The following is an explanation for developers.
The source code is implemented only for games and analysis, and does not include any learning functions.

AQ is written so that it can be compiled with C++11/C++14, and the coding conventions are generally referred to the following page.

Google C++ Style Guide

5-1. Linux

Requirements

gcc
make
CUDA Toolkit 10.x
TensorRT 7.0.0

Check the include path and library path of CUDA and TensorRT in the Makefile and make it.

$ make

5-2. Windows

Requirements

Visual Studio 2019 (MSVC v142)
CUDA Toolkit 10.x
TensorRT 7.0.0

Additional include directories:

{your_cuda_path}\NVIDIA GPU Computing Toolkit\CUDA\v10.x\include
{your_tensorrt_path}\TensorRT-7.0.0.xx\include

Additional library directories:

{your_cuda_path}\NVIDIA GPU Computing Toolkit\CUDA\v10.x\lib\x64
{your_tensorrt_path}\TensorRT-7.0.0.xx\lib

Additional library files:

cudart.lib
nvparsers.lib
nvonnxparser.lib
nvinfer.lib

Add each of the above and build it.

6. License

GPLv3
Author: Yu Yamaguchi

SHKD13/AQ