What's Changed

This version is mainly a move to using a stronger default network. Upgrading is not needed if you are already using this network, but the release should make it easier to get started for new users.

Thanks to recent advances, the latest 18b networks with improved architecture are clearly better at basically any settings compared to the old 20/30/40/60b options. Furthermore, it is small enough to include in the release.
The previous default 15b network remains available to download from within general settings, for those with very low resource machines. As a general rule, you should only use this if you experience crashes with the new default network.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the KaTrain.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 to allow installation. 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

This is another small release, but it still recommended, as it includes a new KataGo version (1.13.x) with some interesting new features and bug fixes, including yet another new type of network.

It also fixes a small bug in the NGF file format.

See other releases for installation details.

This is a small release, but it still recommended, as it includes a new KataGo version with some interesting new features, including a new type of network.

Changes

• Included KataGo 1.12.1 -> 1.12.2 -> 1.12.3
  • This includes a new 18b network that is between old 40b and 60b strength, read more about it here.
  • Note that the versions being equal is more a coincidence, KaTrain 1.12 does not include KataGo 1.12.
• Ownership visualization changes and fixes
  • Fixed some ownership visualization bugs in teaching mode
  • Extended theming options for ownership
  • Slight changes to make the default theme simpler

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the KaTrain.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 to allow installation. 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

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

Patches

• 1.12.2: replaced katago versions as the earlier release was buggy and blocked from contributing
• 1.12.3: another katago update

New features:

• Ownership visualization was improved, thanks to the incredible work of @jacobm-tech
  • The default style is now blended, but you can theme it to use marks, blocks, or blended style, and choose when to mark stones
  • See themes for all the options
  • Old themes have been updated to stay close to their former style
  • Design improvement suggestions or bug reports can be added to this issue
  • The default may change, particularly between 'all' or 'weak' stones marked, here is a quick poll to inform this decision
• Deeper analysis can now be applied only to a specific move range
  *Continuous analysis and other extra analysis modes are now less aggressive in turning 'top move' hints on.
  • Using shift+spacebar instead of spacebar avoids turning them on in the remaining of starting continuous analysis.

Bug fixes and minor changes:

• Python 3.10 is supported again
• Wide root noise works correctly when set to 0.0 in config, this previously reverted to the default.
• Board rotation was fixed
  • +Fix region of interest when board is rotated
  • +No longer dependent on numpy, reducing binary size and improving startup time
• An improvement in the display for high resolution displays on windows
• When certain hints are turned off, as in the lizzie theme, hovering over them is now disabled as well
• Windows executables should now include version information, thanks to @ulty4life

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the KaTrain.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 to allow installation. 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

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

This is a minor update with mainly some bug fixes.

Bug fixes

• Cache analysis in SGF was accidentally dropped from the analysis options, this has been fixed
• Minor fixes to sounds and edge cases for handicaps on tiny boards.

New features

• Board rotation button, thanks to @Funkenschlag1

Update

• 1.11.1 -> 1.11.2 Fix for some issues with the windows builds and config file versions.
  • Note that the new windows builds are quite a bit larger due to numpy binaries, so it is recommended to use the .zip version over the standalone .exe as the latter will be even slower to start
• OSX binary updated with new tag (1.11.2fixes-for-osx)

New Features

• Included KataGo upgraded to v1.11 see improvements here
• Tsumego Frame, thanks to @kaorahi https://github.com/sanderland/katrain/issues/498
• Prune branch option in the move tree. This removes all side branches leading up to the selected node.
• Turkish Translation, thanks to "Bora Zafer"
• Keyboard shortcuts for contribution
  • Esc gracefully aborts contribution, finishing current games
  • Pause pauses/resumes contribution
  • To forcefully exit KataGo without finishing games in progress, just quit KaTrain itself
• Estimated territory restyling, thanks to @milescrawford in #487
• High precision score near 0, thanks to @pdeblanc in #514
  • This enables an option to show score estimates near 0 to 2 significant digits, which can be enabled under analysis settings.

Technical changes and fixes

• Upgrade to Kivy 2.1
  • The MacOSX build should hopefully be improved by this.
  • Python 3.6 support was dropped.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the KaTrain.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 to allow installation. 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

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

Major additions

• Continuous analysis or 'pondering' has been improved.
  • It will now no longer schedule queries with increasing visits, but just use a single never-ending query.
  • This also fixed a bug with the region of interest function
  • This will break compatibility with KataGo versions older than v1.7.0.
• KataGo was upgraded to 1.10.0.
  • The linux executable now includes a self-compiled, statically linked libzip, which should reduce issues with versioning.
• An AntiMirror AI option was added which uses KataGo's special mode for beating players who play mirror go.
• Scrolling through variations now only works while the cursor is on the board, reducing conflict with browsing the move tree.
• Middle clicking while scrolling through variations now adds it to the move tree.

Minor fixes and additions

• The SGF 'compressed points list' functionality which allows you to place a square of stones is now supported
• On MacOS, command should function as ctrl
• The log file setting in the default config was removed, as it was broken
• A bug was fixed where the contribute function could break if the last game included handicap stones.
• The MacOS packages should now have correct versioning

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 to allow installation. 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

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

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.

This is a minor patch which includes:

• Support for rulesets which allow suicide, including in distributed training. The lack of support for this caused occasional errors when contributing to the distributed training project.
• Updated for downloading KataGo 1.8.1 in general settings, instead of KataGo 1.8.0

If you are not using KaTrain to contribute to distributed training, there is likely no need to update.

YouTube Tutorials

• Generated positions

Major new features

• Contribute to KataGo's distributed training run!

  • A new option in the main menu will assist you in setting up contributing to distributed training
  • Included binaries for Windows, Linux and MacOS should all support this mode.
    • Keep in mind that the newer M1 macs needs you to compile katago yourself for this, as the current brew version does not support distributed training.
  • You can watch games being played, exploring policy, potential moves and variations.
  • Hit [spacebar] to switch between automatically playing and manually browsing through the current game.
  • Most other options are disabled in this mode.
  • See here for more details.

• Setup position in new game

  • The new game now has tabs for new game/edit rules/setup position
  • Setup position will generate a position where one player is ahead.
  • The intended use for this is to play against KataGo from an advantage, and try to win the game.
    • For an extra challenge use KataHandicap, but remember to manually set the playout doubling advantage.

Minor features and bug fixes

• The 'show dots' toggle is back to having only two options, all off and 'some on'.
  • This was mainly due to the 'next mistake' navigation making the view with all evaluations somewhat redundant, and not warranting the confusing 3-state checkbox.
  • The option to determine how many moves to show then on is back in analysis options configuration.
• The window size/position is now saved on exit and restored on startup.
• The fast analysis and rewind to start options in 'load game' are now remembered.
• A new analysis option 'Reset analysis' was added which resets analysis to a single engine query, removing alternate moves and child move derived info.
• A new shortcut [escape] stops all analysis.
  • This can break some features which expect analysis to be present, such as AI moves. Resetting with h or toggling continuous analysis will typically fix such edge cases.
• Nodes with clear location commands in the sgf (AE) are now correctly shown.
  • However, they are not analyzed.
  • Nodes with only edit position commands (AB/AW/AE) are now indicated in grey with a + in the move tree
• Scoring by ownership square counting in japanese rules no longer confuses the last dame with a point.

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.zip (unzip, mount .dmg, drag .app to applications)
  • 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 or follow instructions here.

Patches

• 1.8.1 Fix for single exe (homeDataDir)
• 1.8.2 Fix for cacert on alternate katago and sizing on retina displays.
• 1.8.3 Fix for >1M visits display and windows single exe distributed engine startup

This is another minor update, improving on some issues found in 1.7.1, and including better support for downloading models.

I've also managed to create a packaged release for OSX, thanks to kivy developer @matham. This package includes a pre-compiled katago executable and should be all you need to run KaTrain on OSX. So far this has been tested on OSX 10.14.

Features:

• You can now download the confidently strongest distributed model from general settings.
• You can now press shift-b to navigate from a deep variation back to the main branch, thanks to @LiamHz

Bug fixes

• Better stabiility for model downloads.
• Queries should be properly cleared on new game, preventing an incorrect 'forever busy' engine status.
• Fix for initial player detection using PL[]

New Theme & New YouTube Tutorial

• See here for the first theme added.
• See here for a new YouTube video on using the 'insert moves' feature to improve your ability to review games in situations when both players ignore an urgent move for a long time.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster to start up)
• MacOS users can use the attached KaTrainOSX.zip (unzip, mount .dmg, drag .app to applications)
  • Note that on the newer Macs with M1 processor you still need to brew install katago
• Linux and MacOS users can install using pip3 install -U katrain or follow instructions here.

Update 1.7.3

• Fixes a bug in downloading katago versions.
• Shuts down faster if an external command is used.
• Avoids using the provided exe for new M1 macs and looks for a brewed binary instead.
• Uses an older pyinstaller to give less false positives for antivirus programs

Update 1.7.4

• Fixed a bug in download models.

Update 1.7.6

• Better support for M1

This release includes an upgrade to the latest KataGo version, along with a number of minor features and bug fixes.

Features:

• The built-in KataGo, as well as the additional versions that can be downloaded, have been upgraded to v1.8
  • These are compatible with the newest distributed models
  • Using 'download models' in general settings will download the latest model of the distributed run.
• SGF file improvements
  • You can now use the right click 'open with' feature of your OS to open an SGF file
  • KaTrain will now try to determine the encoding for SGF files without one, instead of using latin-1. This should help Chinese SGF files in particular
  • Pressing 'enter' in the load/save dialog when a directory is in the text field now navigates to that location
• The root node is now analyzed using the 'fast' setting in a new game. This should make startup a bit quicker. Likewise, on changing models or rules, fast analysis is used to re-analyze the game.
• Ancient chinese "stone scoring" rules option which includes group tax, thanks to @pdeblanc
• Traditional Chinese translation thanks to @Tony-Liou
• Some elements of the UI can now be resized using the themes feature.

Bug fixes:

• Fix that prevents the automatic self-play feature from deadlocking when many simultaneous games were going on at the same time
• Loading generated player names are now ignored
• Saving analysis to existing SGF files no longer gives errors on re-loading
• Passes in top moves no longer results in SQ[] in SGF files
• Support for [tt] as passs on <19x19 boards
• Invalid HA properties are ignored instead of causing crashes
• Alt/Tab shortcuts should no longer interfere with switching windows using Alt-Tab
• Better guess for the initial player, respecting the PL tag and existing branches. This should help unusual handicap placements.
• Font size for the policy moves now scales properly.
• Configuration popups are restricted to the window height, such that the save button is always visible.
• Show dots as 'all off' now properly saved in config and respected on restarting
• Upper-case extensions such as .SGF now show up in load file
• Pressing up/down in the move tree when on a collapsed path no longer causes an error.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• Linux and MacOS users can install using pip install -U katrain or follow instructions here.

A little history and a big thank you

This project was started at the end of last year as a small experiment in making a graphical UI for something, and has since grown to one of the most powerful tools for Go AI analysis. This could not have been done without the support and contributions of many. A big thank you to all them, as well as all the people who contacted me on reddit and discord to send me helpful feedback, kind words and go books. Finally, thanks to all my Github sponsors for their support.
To highlight the effect of some of the major contributors, I've prepared a little history highlighting how the program changed since release.

Major New Features

• You are now free to show any two statistics on the 'top moves', including visits, (change in) win rate, (change in) score.
• The analysis menu now includes several new options:
  • Select a region to search, restricting analysis to this part of the board until cancelled.
    • This is particularly useful for tsumego solving or joseki analysis. See the video below for an example.
    • The old 'local moves' has been removed in favour of this option.
  • Insert moves: this mode allows you to insert moves in-between the current and next move, creating a new variation in which the moves are played out as long as they're legal (skipping over any inserted moves).
    • This is helpful for improving analysis when a certain exchange or life & death situation is ignored by both players for a long time.
  • Play out the game to the end.
    • This can be used as a more vivid way to visualize which territories could end up with each player.
    • Note that you can right-click the generated node and 'un-collapse' it (or press c) to see the entire game.
• Analysis can now be cached in the SGF, causing analysis to be instantly available upon loading with no need for calls to KataGo
  • Note that this uses tags unique to KaTrain, and the resulting files can be >1Mb.
  • If you want to do additional analysis after loading, using the same model file is recommended.
• Support for themes, see here for details.
  • If you make any interesting themes, I would be happy to add them to the repository.

Local Joseki Analysis video

Minor New Features and Changes

• You can now edit player names similarly to changing komi and rules.
• Saving a game no longer uses a default filename, but prompts you for one. Subsequent saves use the same file, unless 'save as' is used.
• Generated comments and player names are now filtered out from loaded SGFs
  • Particularly, loading and saving repeatedly no longer causes analysis comments to duplicate.
  • Note that this only applies to files saved with the current version.
• You can now go back to the last branching point with b.
• You can collapse branches up to the last branching point with c. These collapsed states are also saved in SGF files.
• The policy moves view has been revamped to show the numerical value, and coloured by order of magnitude.
• Minimizing the score graph in analysis mode now expands the move tree.
• You can toggle coordinates on/off with k, thanks to @blamarche.
• You can now go to your previous mistake with shift-n or the backward red arrow.
• Some keyboard shortcuts have been added or changed, see the manual for details.
• Spanish has been removed as a language option as it could not be maintained. If you are interested in contributing, please see these instructions.

Bug fixes and performance improvements

• Rendering has been sped up significantly by caching textures. This should make variations smoother in particular.
• Empty komi values in SGFs no longer cause errors.
• The PL[] tag gets correctly picked up on when loading SGFs with problems.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• Linux and MacOS users can install using pip install -U katrain or follow instructions here.
  • Note that the gui framework kivy had a major release recently, and installation on MacOS seems better in particular.

Enjoy the update, and a very happy holidays!

This release adds a number of features to improve ease of use and responsiveness.

Features:

• The navigation now has a button for 'Next mistake' which forwards to the next point in the game with an 'orange' (3 point by default) mistake or worse.
  • If you don't want to see your opponent mistakes, set them to 'AI' and they will be skipped.
• Integration with the new 1.7.0 version of KataGo has been improved:
  • smoother updates to analysis in progress.
  • on loading a new game, previous queries will be terminated, so you do not have to wait for useless results.
• The analysis menu has a new 'local search' option which searches within 5 spaces of the last move.
• The simple-style AI has been added from 1.5.1. This option tries to settle territory, often leading to simpler moves.
  • This AI has not yet been calibrated and is just displayed as '2 dan', but increasing the max point loss will weaken it.
• Timer options have been improved.
  • You can set a 'main time' in addition to byo-yomi
  • You can set a 'minimal thinking time in byo-yomi', which blocks you moving too fast.
• You can now update the komi and rules of a game in progress in the 'new game' screen.
  • Note that this triggers re-analysis of the entire game.
• You can now right-click a node in the move tree and make that branch the main/top one.
• The 'show dots' option now cycles between 'show all', 'show some' and 'show none' to avoid you having to go into analysis settings and set this to 0 when you want a game with no analysis information.
• Clicking on the "B" or "W" circle in player options now swaps the players, making it easier to switch colours between games.
• You can now paste a URL straight into the program with ctrl-v and your SGF will be downloaded and loaded, thanks to @wierzbowski
• The engine status dot now shows the number of outstanding queries when there are more than 2. This should help get an indication of how long your SGF takes to analyze.
• The 'top moves' score change display no longer caps at 0.0, but shows positive changes as well, which tend to happen when a 'surprising' move is found by the engine.

Bug fixes:

• A suboptimal setting for the search was changed in v1.5.1, this has been fixed, and analysis should be faster.
• Move placements in SGF files could occasionally lead to an error, which has been fixed.
• Fonts should scale by your operating system's font settings, making the UI look better for people with very high screen resolutions.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• Linux and MacOS users can install using pip install katrain or follow instructions here.

Enjoy!

This is a pre-release intended to crowd-source the testing and refining of a new AI option.

Specifically it includes some AI options that are intended to play in a 'simple' way, but still leverage the full power of KataGo, avoiding some of the blind spots that the policy based AIs have.

As a little extra, it also has support for KataGo's latest feature for reporting back partial analysis queries, so the feedback during analysis should be a lot more responsive.

AI Options

The new options are:

• Simple style: cares about all territory, preferring moves which clearly take or solidify own territory, even if this also solidifies the opponents territory.
• Settle style: Similar, but only cares for stones, see issue #215 for details.

I am mainly interested in people's experience in how these AIs play, which one is nicer to play against, and any weird behaviour they exhibit.

Giving feedback

Any reports of experimenting with the settings is useful. You can add your experiences to this issue.

• Useful: Feedback on which settings are more enjoyable to play against over the span of one or more games
• Useful: Estimates of playing strenght at different settings (e.g. I am 1 dan and found these settings to give me a good opponent), or self-play experiments.
• Useful: Suggestions for improvment to the move selection.
• OK: Situations with huge blunders which destroy enjoyment, such as inappropriate passing, saved with full SGF ('ai thoughts') output.
• OK: Sharing games which you found particularly enjoyable or interesting.
• Less useful: Finding individual situations in which you find the move chosen to be 'not simple'.

In terms of calibrating the strength, these settings are expected to be most important:

• max_points_lost - A higher value will be weaker, and a very low value reverts back to normal KataGo behaviour.
• settled_weight - A higher value will be weaker, but play more strongly according to the style
• wide_root_noise (in engine settings) - A higher value (of 0.02-0.05) will return more candidate moves, giving more opportunities to prefer the simple style, but also increase the chance of blunders.
• max_visits (in engine settings) - more visits, more options, more likely to find a move appropriate to the style.

Fun experiments

For additional fun experiments, note:

• A negative settled_weight will prefer unsettledness, leading to complicated positions
• A positive settled_weight with a higher negative opponent_fac will prefer unsettledness of the opponent, leading to invasions.

Attachment and tenuki penalties can also be negative or zero to make these moves prefered instead of avoided.

These kind of inverse settings are not the focus of this release, but feel free to share interesting games along with their settings.

Installation

Note that these AIs require features of KataGo which are not in the last release, so you need to use either the built-in opencl katago provided (which is up-to-date) or compile from source yourself.

• For windows, just download and run the attached .exe, or download the .zip and run KaTrain.exe (which is faster to start)
• For linux, note that this release has not been uploaded to PyPi, but you can run the following to install it:
  • pip install https://github.com/sanderland/katrain/archive/v1.5.1.zip
  • Alternatively for running it without installation, you can git clone the branch and run it as usual with python -m katrain
  • The included opencl KataGo is updated for linux to include the latest unreleased fetures.
• For MacOS, follow the linux instructions, and compile KataGo's master branch from source.

Improvements

• A number of significant of graphical updates to analysis
  • The next moves are shown as a dashed line around the move rather than a semi-transparent stone, as overlap with 'top moves' hints was confusing.
    • If the next move is the top move, a dashed line with blue and the next player will be shown.
  • Top moves are softer circles, and fade out for low (<25) visits. This should both make any borders clearer as well as make the board less overwhelming. The threshold can be configured in config.json (low_visits) but is not yet in the UI.
  • When viewing policy moves, 'top moves' are now hidden to avoid overlap.
• A new analysis option, 'find alternative moves', has been added. This will do a 'fast visits' search on all current move options, as well as request a second query avoiding all current moves.
• The model and katago binary dropdowns now show a little description of the files you can select.
  • A bug where downloaded katago versions didn't show up in the dropdown has been fixed.
• Resignation is now possible. This is mainly to allow people to have more complete SGF records.
  • Game results are now stored in the SGF as long as the result (B+R, W+3.5, etc) is showing on top of the board.
• The rank estimator has been put away, as it was causing more confusion than anything and not actively being improved.
• Improved support for FoxWQ's incorrectly formatted SGF files, with extreme komi/weird handicap settings being converted to reasonable values when the SGF contains "AP[foxwq]"
• Rule set and komi are now shown in info on the first move.

Bug fixes:

• A bug where the first player was incorrect for 1-stone handicap games was fixed.
• A bug where katago kept running in the background on windows after the program closed has been fixed.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• Linux and MacOS users can install using pip install katrain or follow instructions here.

Enjoy!

With the release of KataGo v1.6.x, efficient support for CPU-only KataGo is finally here!

Short video with new features

Features

• Download and select any KataGo binary for windows or linux directly from within KaTrain.
  • Selecting an 'eigen' binary will allow you to use KaTrain without a GPU!
  • See the KataGo release notes for more information.
• Override KataGo command.
  • Previously implemented as a hack where you could "quote" your katago path, it is now a separate field.
  • This can be used to connect to a remote server running a KataGo analysis engine.

• Option to show point loss as text.

  • As the number of users has grown, it's clear that some prefer to see the point loss on each candidate move in detail, whether it be for analyzing pro games, or a difficulty distinguishing colours.
  • Although still turned off by default for a cleaner look, the option for this can be found under 'teaching/analysis settings'.

• Animated 'pondering' indication when continuous analysis is on.

  • Before, it was often not clear whether the engine was still pondering or not, causing some confusion.
  • It now shows an half-orange and half-yellow spinning circle where the engine busy status is indicated.

• Finally, when a move is undone in teaching mode, 'expected territory' will show expected losses in red.
  • This should allow for a hint on the important regions of the board, without checking the expected refutation in detail (which often gives away a bit too much).

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• Linux and MacOS users can install using pip install katrain or follow instructions here.
  • Note that unfortunately there are currently no pre-compiled binaries for mac for the newer KataGo versions.

Enjoy!

New video on analyzing games:

Mostly minor improvements in this release.

• SGF comments are shown in the 'info' field. Note that if the sgf was saved by KaTrain, this includes comments/notes previously generated.
• SGF improvements for some unusual edge cases generated by older files and foxwq.
• IME improvements on the notes field, which should now support typing chinese/japanese/korean more naturally.
• Red-green colourblind theme now available under 'teaching settings'.
• Bug fix for SGF file loading by copy-pasting a filename into the designated field.
• Engine connector made a bit more robust against unexpected input, as seems to happen with some ssh connections.

For information on installing, please see the 1.3.1 release.

Update 1.3.4: Minor fix to teaching settings popup.

This release is relatively small, but as some of the features in it are much requested, I'm putting them out there sooner rather than later. Enjoy!

• Japanese translation, thanks to @kaorahi for contributing.
• Feature: Right click on a node in the move tree to get an option to delete it.
• Feature: enter a command between "double quotes" for the 'katago path' setting will make it be used for the katago command, overriding any models/config setting. This is an experimental feature for power users who want to try remote katago setups.
• Bug fix: The PV animation time setting was fixed.

For information on installing, please see the previous release.

Some exciting new developments going into this version, but before I list the changes..

• Thanks to help from @Kameone, KaTrain now has a YouTube channel where we have recorded some tutorials and overviews of new features. If you have ideas for videos, or want to collaborate, please let me know!
• A big thank you to the new Github and Liberapay sponsors for their support.

Quick overview of New Features

New Features and Improvements

• New/Improved AI options:
  • Handicap AI - Uses KataGo's options to play more aggressively when behind.
  • Better calibrated rank with more human-like behaviour (especially in the opening) thanks to @bale-go.
• New analysis options:
  • Re-analyze game: allows you to review the entire game again to a certain number of visits, great for generating SGFs with accurate in-depth reviews.
  • Continuous analysis: When idle, will improve analysis of the current position, similar to 'pondering' in Lizzie.
• The board now uses textures for the stones/dots and should generally look a lot nicer, thanks to "nimets123" for the graphics.
• Sound effects when stones are placed, thanks to Jordan Seaward for providing the effects.
• The AI options UI has been improved.
  • all settings now use a slider with suggested values instead of having to enter a number.
  • 'core' settings are highlighted and put at the top. changing these settings will give you an estimate of the AI's rank based on self-play against the calibrated rank AI.
  • Note that changing the other, advanced, settings is likely to make these estimates inaccurate.
• An extra panel has been added to the graphs where estimates the rank of both players based on algorithms developed by @bale-go
  • This is a statistical estimate and may be quite variable. Still it may be helpful in determining in what part of the game your weaknesses are.
  • It is recommended not to leave this panel open all the time, as it is computationally expensive.
• Support for Tygem .gib files
• Minor improvement and bug fixes:
  • Player names and ranks shown at the top right when loading SGFs, and saved for KaTrain AIs.
  • 'analyzing' status hidden when done.
  • Shortcut buttons for komi fixed in new game
  • Red colors in the info box are now only used on errors, and the principal variation (PV) is also shown in yellow for better readability.
  • Estimated score/Win rate/Point loss statistics now do not take up space when hidden.
  • Engine is now quicker to give an error when crashing.
  • The top move is now highlighted more clearly with an additional border.
  • Double clicking on a move now goes to the move just before that point in the game, as you are usually interested in alternative moves for the selected one.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• New and improved Linux/MacOS instructions are here.

Patches

v1.3.1: Minor bug fixes and NGF file support

No need to upgrade from 1.3 unless you are encountering one of these minor issues

• Minor bug fix on loading different sized boards in quick succession,
• Minor bug fix on rank estimation in nodes without a move (e.g. pandanet) sgf files.
• Sound files for linux fixed in the pypi package.
• wbaduk ngf file support.