Katago: Difference between revisions

imported>OmnipotentEntity
Update documentation to reflect the new CUDA 11 defaults.
Klinger (talk | contribs)
m added headers
 
(3 intermediate revisions by 2 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 (optional)
       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
Line 12: Line 16:
     }
     }


Using Eigen:
===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 {
     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 36: 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 {
Line 43: Line 59:


[[Category:Applications]]
[[Category:Applications]]
[[Category:Gaming]]