+3
bf70f2cf23
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>
74 lines
3.1 KiB
Markdown
74 lines
3.1 KiB
Markdown
# 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](http://discord.gg/AjTPFpN) (use the #gui channel),
|
|
providing detailed information about your error.
|
|
|
|
|
|
* [General](#General)
|
|
* [GPU vs CPU](#CPU)
|
|
* [Windows specific help](#Windows)
|
|
* [MacOS specific help](#Mac)
|
|
* [Linux specific help](#Linux)
|
|
|
|
|
|
|
|
## <a name="General"></a> General
|
|
|
|
### <a name="CPU"></a> 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.
|
|
|
|
### <a name="Models"></a> 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.
|
|
|
|
|
|
## <a name="Mac"></a><img src="https://upload.wikimedia.org/wikipedia/commons/8/8a/Apple_Logo.svg" alt="macOs" height="35"/> 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.
|
|
|
|
## <a name="Windows"></a><img src="https://upload.wikimedia.org/wikipedia/commons/5/5f/Windows_logo_-_2012.svg" alt="Windows" height="35"/> 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.
|
|
|
|
|
|
## <a name="Linux"></a><img src="https://upload.wikimedia.org/wikipedia/commons/a/ab/Linux_Logo_in_Linux_Libertine_Font.svg" alt="Linux" height="35"/> 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-dev` to
|
|
* Next, try installing all packages mentioned [here](INSTALL.md#LinuxTrouble).
|
|
* A final alternative is to go [here](https://github.com/lightvector/KataGo) and compile KataGo yourself.
|
|
|
|
### Getting more information about errors
|
|
|
|
Check the terminal output around startup time. |