Skip to content

v1.9: Major KataGo upgrade, Peformance reports, Theming

Compare
Choose a tag to compare
@sanderland sanderland released this 28 Jun 15:52
· 28 commits to master since this release
dd3b8cb

image

Major features

  • KataGo Update: This release includes KataGo 1.9 which includes major improvements. Upgrading is highly recommended.

    • A major change is that the win rates and scores are unaffected by wider exploration, which allows for more use of the 'wide root noise' setting encouraging exploration. The default value of this has been changed to 0.04 in both KaTrain and KataGo itself.
    • Particularly, you are likely to see fewer top moves with small positive changes in score, and fewer instances where the win rate/score oscillates at low visits settings.
    • In addition, symmetry is taken into account. You might notice that in opening positions in particular this combination leads to very wide exploration. If you prefer to see fewer moves, you can change the wide root noise in general settings back to a lower value.
    • One side-effect of this is that it breaks compatibility with some older versions (Around 1.7, such as the old 'bigger board size' binary). A new bigger board size binary is included in the downloadable katago versions.
  • Performance Report : F3 / Analysis options now has a "performance report" which shows key statistics including AI match rate, mistakes of various kinds, and an overall rating.

    • Keep in mind that this overall rating number is mainly for entertainment, and a low visit count will potentially result in unreliable numbers. Suggestions for improvements are welcome, but please do not file issues about individual games.
  • Better support for themes

    • Multiple theme files are now supported, allowing more easy installation of multiple themes, such as a board graphics change, and keyboard shortcuts. Any json file starting with "theme" in your settings folder is now included.
    • Keyboard shortcuts can now be defined in themes. Thanks to @electricrgb for helping with this, and pointing out that the current setup can be annoying for non-qwerty keyboards.
    • See here for more information, and further on in these release notes for a contest!

Minor features

  • It is now possible to play a random sound in response to a mistake. See here for a fun example. Thanks to Mikkgo and Jeff for the sounds.
  • When KataGo fails to start, or crashes, a pop-up with more detailed help opens up. This page will be linked as additional help. Feel free to contribute to it with solutions to problems I missed.
  • You can now use the mouse scroll wheel to quickly scroll through a variation when hovering over a candidate move. Thanks to @xiaoyifang for implementing this.
  • You can now turn off window size/position restoration in general settings. This can help if this feature does strange things on multiple monitor setups.
  • Sound should be more reliable, especially on Linux.

Theme contest

  • To encourage exploration and development of the themes support, there will be a small contest during July.
    • Valid contributions include both theme packages, as well as code that improves theme support or default looks and widget design.
    • See the OGS forums topic for details.

Installation

  • Windows users can simply download and run the KaTrain.exe file attached, or download the KaTrainWindows.zip file and run the .exe in that (which is slightly faster to start up)
  • macOS users can use the attached KaTrainOSX.dmg (open, drag .app to applications). The first time you start the app, you will need to control-click the app in finder. Note that on the newer Macs with M1 architecture, you still need to brew install katago, or compile katago yourself.
  • Linux and macOS users can install using pip3 install -U katrain
  • For troubleshooting and installation from source follow instructions here.

After installing the program, it is recommended to check general settings (F8) and download the latest katago models.

Patches

  • 1.9.1: Fix for KivyMD breaking MRO on a patch upgrade
  • 1.9.2: Upgrade to KataGo 1.9.1, preventing crashes of the engine.
  • 1.9.3: Tiny fix for mac sounds, windows executables remain at 1.9.2 as they are unaffected.