Katago: Difference between revisions

From NixOS Wiki
imported>OmnipotentEntity
No edit summary
Klinger (talk | contribs)
m added headers
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Katago is a very strong go engine.
[https://github.com/lightvector/katago Katago] is a very strong go engine. It has no GUI and has to be used with [https://github.com/sanderland/katrain KaTrain], [https://github.com/featurecat/lizzie Lizzie], [https://github.com/rooklift/ogatak Ogatak], [https://github.com/bernds/q5Go q5Go] or other tools like [https://sabaki.yichuanshen.de/ Sabaki].


There are several build options for Katago's derivation.  Katago can use either Eigen, OpenCL, or CUDA.  By default, it uses OpenCL.


Using CUDA:
== Installation==
There are several build options for Katago's derivation.  Katago can use either Eigen, OpenCL, CUDA, or TensorRT.  By default, it uses OpenCL.  To use a different backend override the `backend` attribute, allowed values are "eigen", "opencl", "cuda", and "tensorrt".
 
For the eigen and cuda backends either version should be more or less functionally the same.
 
===Using CUDA===


     katago.override {
     katago.override {
       enableCuda = true;
       backend = "cuda";
       cudnn = cudnn_cudatoolkit_10_2; # insert your favorite version of CUDA here
       cudnn = cudnn_cudatoolkit_10_2; # insert your favorite version of CUDA here (optional)
       cudatoolkit = cudatoolkit_10_2; # I recommend at least CUDA 10, because older versions suffer major performance penalties
       cudatoolkit = cudatoolkit_10_2; # I recommend at least CUDA 10, because older versions suffer major performance penalties
      stdev = gcc8Stdev; # If you specify CUDA 10 or below you must also override the gcc version, this is due to NVidia compiler support.
    }
===Using Eigen===
    katago.override {
      backend = "eigen";
     }
     }


Using Eigen:
===Using TensorRT===
First download the tensorrt redistributable installer from https://developer.nvidia.com/tensorrt and add it to your nix-store.
 
Note that you need an NVidia account (free) to do this.


     katago.override {
     katago.override {
       enableGPU = false;
       backend = "tensorrt";
      enableTrtPlanCache = true; # Recommended to speed up booting, but uses additional disk space, so not recommended for contrib.
     }
     }


==Configuration==
If your processor support AVX2, you might want to enable it:
If your processor support AVX2, you might want to enable it:


Line 35: Line 51:
     }
     }


Enabling [https://katagotraining.org/] contributions:
=== Contribute to the neural net ===
Enabling [https://katagotraining.org/] contributions to the neural net:


     katago.override {
     katago.override {
       enableContrib = true;
       enableContrib = true;
      openssl = openssl;
      git = git;
     }
     }
[[Category:Applications]]
[[Category:Gaming]]

Latest revision as of 21:44, 26 September 2024

Katago is a very strong go engine. It has no GUI and has to be used with KaTrain, Lizzie, Ogatak, q5Go or other tools like Sabaki.


Installation

There are several build options for Katago's derivation. Katago can use either Eigen, OpenCL, CUDA, or TensorRT. By default, it uses OpenCL. To use a different backend override the `backend` attribute, allowed values are "eigen", "opencl", "cuda", and "tensorrt".

For the eigen and cuda backends either version should be more or less functionally the same.

Using CUDA

   katago.override {
     backend = "cuda";
     cudnn = cudnn_cudatoolkit_10_2; # insert your favorite version of CUDA here (optional)
     cudatoolkit = cudatoolkit_10_2; # I recommend at least CUDA 10, because older versions suffer major performance penalties
     stdev = gcc8Stdev; # If you specify CUDA 10 or below you must also override the gcc version, this is due to NVidia compiler support.
   }

Using Eigen

   katago.override {
     backend = "eigen";
   }

Using TensorRT

First download the tensorrt redistributable installer from https://developer.nvidia.com/tensorrt and add it to your nix-store.

Note that you need an NVidia account (free) to do this.

   katago.override {
     backend = "tensorrt";
     enableTrtPlanCache = true; # Recommended to speed up booting, but uses additional disk space, so not recommended for contrib.
   }

Configuration

If your processor support AVX2, you might want to enable it:

   katago.override {
     enableAVX2 = true;
   }

By default, katago uses the TCMalloc memory allocator. It is not recommended that you disable it due to severe fragmentation issues after running katago for a few hours. However, if you cannot use TCMalloc, and you do not plan on running katago for extended periods of time, you can disable it anyway.

   katago.override {
     enableTcmalloc = false;
   }

Katago also supports large boards (up to 29x29); however, there are no networks trained specifically on them, and enabling them slows down even normal sized board play, so it is disabled by default. If you want to enable support:

   katago.override {
     enableBigBoards = true;
   }

Contribute to the neural net

Enabling [1] contributions to the neural net:

   katago.override {
     enableContrib = true;
   }