bf70f2cf23
* refactor priorities * performance report doodling * shutup pycharm * more doodling * doodle tricol * tweak report, fix bug in insert * reorder colors * another metric * sorting engines, trying to catch exc * restructure engine err * restructure engine err * test stuff * test report * test report * test and readme * test and readme * layout * engine recov * pixelfix and exes * readme * keyboard shortcut override * oops * mistakes only deeper * black and readme * readme * fix #421, scale repor * Add shortcut variables (#420) * Add shortcut variables * Address comments and missed shortcuts * fix shortcuts * rename, design report, fix report * make translators work more * relative mid/opening/endgame bounds * win size dbg * more errros * entry * jeff mode * fix * readme * edit THEMES.md * edit katrain/core/ai.py, edit katrain/gui/kivyutils.py * jp (#423) * edit THEMES.md * edit katrain/__main__.py, edit katrain/gui/kivyutils.py and 1 other changes * Update katrain.po (#425) 1.9 first French .po * edit katrain/i18n/locales/fr/LC_MESSAGES/katrain.mo * edit katrain/core/ai.py, edit katrain/gui/popups.py * bluedabadee * fix sgf and black * edit katrain/i18n/locales/fr/LC_MESSAGES/katrain.po * ko * Update zh-TW translation (#426) * cn * cn * Some corrections to Chinese translations (#427) * some corrections in cn and tw * better trans * edit CONTRIBUTIONS.md, edit katrain/i18n/locales/cn/LC_MESSAGES/katrain.mo and 1 other changes * de * tw * player what only * add green background to better value (#428) * edit katrain/gui/popups.py, edit katrain/gui/theme.py * Russian for 1.9 (#432) * edit katrain/i18n/locales/ru/LC_MESSAGES/katrain.po, edit katrain/gui.kv and 1 other changes * sound fix * sound fix * fmt * fix sound * edit THEMES.md, edit CONTRIBUTIONS.md and 1 other changes * sound fix * Do not use ffpyplayer on Windows (#434) * edit katrain/gui/sound.py * no pr * jeff theme * stopsound * sound and theme fix * font fix and more errs * French po corrections (#441) Former translations were misleading. It should be accurate now. * add mouse scroll to browser through node variations. (#442) * add mouse scroll to browser through node variations. * add mouse scroll to browser through node variations. * add mouse scroll to browser through node variations. * edit katrain/popups.kv, edit katrain/__main__.py and 2 other changes * windows binary, black * linux binary * edit INSTALL.md * edit .github/workflows/osxbuild.yaml * edit .github/workflows/osxbuild.yaml * edit .github/workflows/osxbuild.yaml Co-authored-by: Sander Land <sander.land@cognite.com> Co-authored-by: roux g. buciu <11182210+electricRGB@users.noreply.github.com> Co-authored-by: kaorahi <38910552+kaorahi@users.noreply.github.com> Co-authored-by: Dontbtme <66470440+Dontbtme@users.noreply.github.com> Co-authored-by: Liou, Guan-Cheng <Tony-Liou@users.noreply.github.com> Co-authored-by: Ching-yu Lin <60384727+chingyulin@users.noreply.github.com> Co-authored-by: xiaoyifang <105986+xiaoyifang@users.noreply.github.com> Co-authored-by: Alexander Kiselev <satoshi.yoda.register.264@gmail.com> Co-authored-by: Sander Land <Sander@bioeng219-lap.isd.kcl.ac.uk> Co-authored-by: Carton He <cartonhe@gmail.com> Co-authored-by: Sander Land <sander.land@aroni.fritz.box> Co-authored-by: Sander Land <sander.land@futurefacts.nl>
3.1 KiB
KataGo troubleshooting
This page lists common ways in which the provided KataGo fails to work out of the box, and how to resolve these issues. If you find your problem is not in here, you can ask on the Leela Zero & Friends Discord (use the #gui channel), providing detailed information about your error.
General
GPU vs CPU
The standard executables assume you have a compatible graphics card (GPU). If you don't, KataGo will fail to start in ways that are difficult for KaTrain to pick up.
On Windows and Linux, you should be able to resolve this by:
- Going to general and engine settings (F8)
- Click 'download katago versions' and wait for downloads to finish.
- Select a CPU based KataGo version (named 'Eigen' after the library it uses).
Keep in mind that a CPU based engine can be significantly slower, and you may want to set your maximum number of visits to a lower number to compensate for this.
KataGo model versions
KataGo models have changed over time, and selecting an older executable with a newer model can lead to errors. Of the provided binaries, this is typically the case for the 1.6.1 'bigger boards' binary, which should only be used with the standard 15/20/30/40 block models, and not the newer distributed training models.
For macOS users
Running from source
Make sure you brew install katago or set the engine path to your own KataGo binary, as there is no executable included.
New Macs with M1 architecture
Make sure you brew install katago as the provided executable does not work on rosetta.
Getting more information about errors
On macOS, the .app distributable will not show a console, so you will need install using pip to see the console window.
For Windows users
Getting more information about errors
Run DebugKaTrain.exe, which is released in the .zip file distributable in releases. This will show a console window which typically tells you more.
For Linux users
libzip compatibility
The most common KataGo issue relates to different libzip versions in the provided executables. Although the provided executables should work on the latest versions of Ubuntu, various other versions and distros differ in their libzip version.
- First, try
sudo apt-get install libzip-devto - Next, try installing all packages mentioned here.
- A final alternative is to go here and compile KataGo yourself.
Getting more information about errors
Check the terminal output around startup time.