KataGo的使用方法

前言

今天看到有开源的围棋AI软件KataGo可以玩。
下载来玩一下，记录一下KataGo下载后怎么配置，怎么使用，怎么和引擎人机下棋。

笔记

进入KataGo的github主页
往下翻，找到安装和配置说明

KataGo
Summary
Current Status and History
Comparisons to Other Bots
Older Runs
Where To Download Stuff
Setting Up and Running KataGo
GUIs
Windows and Linux // 点击windows下的设置和运行说明选项

来到新页面 https://github.com/lightvector/KataGo#windows-and-linux
会定位到如下说明

Windows and Linux
KataGo currently officially supports both Windows and Linux, with precompiled executables provided each release. Not all different OS versions and compilers have been tested, so if you encounter problems, feel free to open an issue. KataGo can also of course be compiled from source on Windows via MSVC on Windows or on Linux via usual compilers like g++, documented further down.

这段说明中 “precompiled executables provided each release”是一个超链接，点进去
precompiled executables provided each release

进入发布版本下载页面
https://github.com/lightvector/KataGo/releases
往下翻，可以看见最新版本的下载连接，选一个适合自己的版本。

katago-v1.7.0-cpu-eigen-avx2-linux-x64.zip
19 MB
katago-v1.7.0-cpu-eigen-avx2-windows-x64.zip
1.4 MB
katago-v1.7.0-cpu-eigen-linux-x64.zip
18.9 MB
katago-v1.7.0-cpu-eigen-windows-x64.zip
1.38 MB
katago-v1.7.0-gpu-cuda10.2-linux-x64.zip
18.4 MB
katago-v1.7.0-gpu-cuda10.2-windows-x64.zip
1.5 MB
katago-v1.7.0-gpu-cuda11.1-linux-x64.zip
18.4 MB
katago-v1.7.0-gpu-cuda11.1-windows-x64.zip
1.65 MB
katago-v1.7.0-gpu-opencl-linux-x64.zip
19.4 MB
katago-v1.7.0-gpu-opencl-windows-x32-dont-use-unless-actually-32bit-windows.zip
1010 KB
katago-v1.7.0-gpu-opencl-windows-x64.zip
1.47 MB
Source code
(zip)
Source code
(tar.gz)

我的环境是最新版win10, 我选的是 katago-v1.7.0-gpu-opencl-windows-x64.zip
下载完 katago-v1.7.0-gpu-opencl-windows-x64.zip，解压到katago-v1.7.0-gpu-opencl-windows-x64目录。

先看README.txt, 看看作者说怎么配置软件。

DOWNLOAD neural nets here if you don't have one: https://d3dndmfyhecmj0.cloudfront.net/g170/neuralnets/index.html

首先去下载神经网络的训练文件https://d3dndmfyhecmj0.cloudfront.net/g170/neuralnets/index.html

看看bin.gz后缀的文件，选一个下载

katago-public/g170/neuralnets
[ 13K]  README.txt
Full History of Self-Play Nets
[   0]  selfplayhistory

Full History of Extra Nets
[   0]  extrahistory

Main-Line Selfplay Nets
[8.4M]  g170-b6c96-s175395328-d26788732.zip
[3.6M]  g170-b6c96-s175395328-d26788732.bin.gz
[ 24M]  g170-b10c128-s197428736-d67404019.zip
[ 11M]  g170-b10c128-s197428736-d67404019.bin.gz
[ 81M]  g170-b15c192-s497233664-d149638345.zip
[ 35M]  g170-b15c192-s497233664-d149638345.bin.gz
[192M]  g170-b20c256x2-s668214784-d222255714.zip
[ 83M]  g170-b20c256x2-s668214784-d222255714.bin.gz
[192M]  g170-b20c256x2-s1039565568-d285739972.zip
[ 83M]  g170-b20c256x2-s1039565568-d285739972.bin.gz
[192M]  g170-b20c256x2-s1420141824-d350969033.zip
[ 83M]  g170-b20c256x2-s1420141824-d350969033.bin.gz
[192M]  g170-b20c256x2-s1856587264-d425711436.zip
[ 83M]  g170-b20c256x2-s1856587264-d425711436.bin.gz
[192M]  g170-b20c256x2-s1913382912-d435450331.zip
[ 83M]  g170-b20c256x2-s1913382912-d435450331.bin.gz
[192M]  g170-b20c256x2-s1982992896-d447159308.zip
[ 83M]  g170-b20c256x2-s1982992896-d447159308.bin.gz
[192M]  g170-b20c256x2-s2107843328-d468617949.zip
[ 83M]  g170-b20c256x2-s2107843328-d468617949.bin.gz
[387M]  g170-b30c320x2-s1287828224-d525929064.zip
[331M]  g170-b40c256x2-s1349368064-d524332537.zip
[387M]  g170-b30c320x2-s1840604672-d633482024.zip

我选的是g170-b10c128-s197428736-d67404019.bin.gz

将 g170-b10c128-s197428736-d67404019.bin.gz拷贝到katago-v1.7.0-gpu-opencl-windows-x64目录

FIRST: Run a command like this to make sure KataGo is working, with the neural net file you downloaded. On OpenCL, it will also tune for your GPU.

./katago.exe benchmark                                                   # if you have default_gtp.cfg and default_model.bin.gz
./katago.exe benchmark -model <NEURALNET>.bin.gz                         # if you have default_gtp.cfg
./katago.exe benchmark -model <NEURALNET>.bin.gz -config gtp_custom.cfg  # use this .bin.gz neural net and this .cfg file

看到 katago.exe 同级目录有default_gtp.cfg 配置文件
所以在cmd窗口运行katago.exe benchmark 运行后报错，说要有default_model.bin.gz 将拷贝过来的g170-b10c128-s197428736-d67404019.bin.gz 改名为default_model.bin.gz 然后再次运行katago.exe benchmark, 这步是确认合适的搜索线程数量, 等程序跑完，会出现一个合适的线程数的推荐值，我的开发机显示为10.

It will tell you a good number of threads. Edit your .cfg file and set "numSearchThreads" to that many to get best performance.

去default_gtp.cfg配置文件中，将numSearchThreads赋值为10
配置文件中， 初始值为 numSearchThreads = 6

# Number of threads to use in search
numSearchThreads = 10

到此katago已经配置好了
但是katago是个后台程序，是个围棋引擎。还需要一个前端的围棋UI.

KataGo should be able to work with any GUI program that supports GTP, as well as any analysis program that supports Leela Zero's `lz-analyze` command, such as Lizzie (https://github.com/featurecat/lizzie) or Sabaki (https://sabaki.yichuanshen.de/).

围棋前端UI可以选 Lizzie 或 Sabaki
我选的是 Sabaki
Sabaki官网中点击下载会跳转到github上的发布页面https://github.com/SabakiHQ/Sabaki/releases/tag/v0.51.1

sabaki-v0.51.1-linux-ia32.AppImage
73.8 MB
sabaki-v0.51.1-linux-x64.AppImage
72.9 MB
sabaki-v0.51.1-mac-x64.7z
41.7 MB
sabaki-v0.51.1-win-ia32-portable.exe
44.7 MB
sabaki-v0.51.1-win-ia32-setup.exe
48.7 MB
sabaki-v0.51.1-win-x64-portable.exe
46.2 MB
sabaki-v0.51.1-win-x64-setup.exe
50.2 MB
Source code
(zip)
Source code
(tar.gz)

选一个不用安装的版本， 我选的是 sabaki-v0.51.1-win-x64-portable.exe

将KataGo关掉
运行 sabaki-v0.51.1-win-x64-portable.exe

修改sabaki语言为中文

选择文件菜单 => 首选项，程序下方会滑出选项页，将语言选为中文，这时会提示重启有效。
将sabaki程序叉掉，重新启动后，语言变为中文了。

指定AI引擎

在滑出的选项页上点击引擎那个平板按钮。

看README.txt

NEXT: A command like this will run KataGo's engine. This is the command to give to your [GUI or analysis program](#guis) so that it can run KataGo.

./katago.exe gtp                                                   # if you have default_gtp.cfg and default_model.bin.gz

指定KataGo.exe所在全路径，参数为gtp, 如下图

开始新对局

选择新对局后，会弹出棋手设置窗口。
选黑棋为自己。

将白棋设置为AI引擎

点击确定就可以开始和计算机开搞了。

点击确定后，可以看到软件屏幕左边显示KataGo引擎已经准备好，可以和sabaki前端交互了

KataGo简单配置和使用就到此结束。
此时，我们是黑棋，只要一落子，sabaki作为白棋，用不了几秒就有回应。当然我们是干不过白棋的了，只是学习和消遣。

下了几手如下

可以看到左边屏幕的引擎下棋的日志显示。

2021/4/25 CL_PLATFORM_NOT_FOUND_KHR

今天发现系统盘200GB的SSD已经快满了。
就将500GSSD换成主盘，重新装了win10.
装完后，想整一盘休息一会。
将以前配置好的kataGo备份解压到D盘，运行 sabaki-v0.51.1-win-x64-portable.exe，发现katago引擎没跑起来。

运行命令行，进入kataGo的目录，运行katago.exe benchmark，出现以下报错

D:\katago-v1.7.0-gpu-opencl-windows-x64_cfg_ok>katago.exe benchmark
2021-04-24 22:01:04+0800: Loading model and initializing benchmark...
2021-04-24 22:01:04+0800: nnRandSeed0 = 17484210821597149788
2021-04-24 22:01:04+0800: After dedups: nnModelFile0 = D:\katago-v1.7.0-gpu-opencl-windows-x64_cfg_ok/default_model.bin.gz useFP16 auto useNHWC auto
Uncaught exception: OpenCL error at C:\Data\Data\Coding\Python\KataGo\cpp\neuralnet\openclhelpers.cpp, func err, line 263, error CL_PLATFORM_NOT_FOUND_KHR

上网查一下 CL_PLATFORM_NOT_FOUND_KHR，都是和GPU相关的错误。
官方版win10U盘(用微软官方工具做的自启动安装U盘)装完，网卡正常，显示正常，分辨率可以调整为1024x768，声卡正常。难道是显卡驱动有问题？
下了360安全卫士，打开360软件管家，装360驱动大师，装驱动失败。装驱动人生，装驱动慢，交了1个月会员，下载嗖嗖的，确实诊断出显卡驱动有问题，一键修复。重启后再扫描，显示驱动都正常了。
卸载360驱动大师和驱动人生。

再去katago目录下，运行命令行 katago.exe benchmark，这回不报错了。果然是win10自带的显卡驱动没装对。但是发现测试出的 numSearchThreads 推荐值为8，比原来少2条线程。

再运行 sabaki-v0.51.1-win-x64-portable.exe，发现kataGo引擎还是没起来。
打开引擎管理，发现我现在放置的目录和原来配置时不同。将kataGo.exe真实的全路径名称填写为kataGo引擎全路径名称。再启动 sabaki-v0.51.1-win-x64-portable.exe， 可以看到kataGo引起起来了。