Releases: sanderland/katrain
Intel based mac installer
Thanks to @pscheid92 we now have both Intel and ARM based installers for Mac.
Enjoy!
KaTrain v1.17.0 / 1.17.1: Human-like models
Thanks to a major contribution from @jtkelm2, KaTrain now includes human-like AI play.
- Download the models through general settings, clicking "download models" and making sure it is selected under "path to human-like models"
- then select one of the two new options (human-like, or historical pro), and set it strength/year in "ai settings".
What's Changed
- Added humanlike models and refactor by @jtkelm2 in #744
- Fix Windows Location Bug by @TuNanTang #743
- Upgrade Kivy, move to uv, fix packaging, improve config UI by @sanderland in #748
Full Changelog: v1.16...v1.17.0
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 .dmg (open, drag .app to applications). The first time you start the app, you will need to go to your privacy settings to allow opening. 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
pipx install katrainorpipx upgrade katrainto install/upgrade in an isolated environment using pipx (and run withkatrain). You can also useuxv katrainto run without installing using uv.
Patches
- 1.17.1 fixes Python 3.13 compatibility. This is released on PyPi only.
v1.16: KataGo update
v1.15 - KataGo update and minor fixes
This release updates KataGo to the latest version, and includes a stronger 18b network by default.
Current training is on the newer 28b model, and if your GPU supports it, downloading the strongest 28b network through the "general settings" panel is recommended.
Fixes and improvements
- Updated KataGo and the 18b network
- @xiaoyifang added a feature to show move numbers (press "m") and a fix for moving through variations
- @rooklift updated performance report to show higher precision
- Pass numAnalysisThreads through the config file rather than command line
- Fixed Ubuntu sound issues
- @lykahb updated code to using poetry for dependencies
- Fixed a bug where certain conditions would lead to errors from broken collapsed subtrees in the navigation panel.
Note that although KataGo 1.15 supports various new features for human-like play, this version of KaTrain does not make us of them.
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)
- The MacOS standalone app is currently not working.
- Linux and macOS users can install using pip3 install -U katrain
- Note that the minimum required Python version has been updated to 3.9, as it is the lowest supported version soon.
1.14: Stronger default network
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
1.13: KataGo upgrade
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.
1.12.3: KataGo upgrade
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
1.12: Blended ownership, bug fixes
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.
1.11.2: Board rotation and Bug fixes
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)
1.11: KataGo upgrade, Tsumego Frame, Turkish translation
New Features
- Included KataGo upgraded to v1.11 see improvements here
- Tsumego Frame, thanks to @kaorahi #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.