Building KataHex - Revision history

4Dummies: /* CUDA */

2026-07-10T00:11:45Z

‎CUDA

4Dummies: /* CUDA */

2026-07-10T00:06:35Z

‎CUDA

4Dummies: /* CUDA */

2026-07-10T00:02:47Z

‎CUDA

Selinger: Some copy-editing. Added an introductory paragraph.

2026-01-25T16:42:08Z

Some copy-editing. Added an introductory paragraph.

Selinger: Selinger moved page Buillding KataHex to Building KataHex: Fixing a typo in the page name

2026-01-25T16:34:30Z

Selinger moved page Buillding KataHex to Building KataHex: Fixing a typo in the page name

4Dummies: Info on downloads

2026-01-19T02:14:35Z

Info on downloads

4Dummies: Clarify

2026-01-19T02:10:30Z

Clarify

4Dummies: Add: how to get and build the code

2026-01-19T01:53:39Z

Add: how to get and build the code

4Dummies at 20:18, 18 January 2026

2026-01-18T20:18:08Z

4Dummies: creation

2026-01-18T19:40:55Z

creation

@@ Line 36: / Line 36: @@
 I have not yet been able to build with the CUDA backend.
-As of July 2026, I have built with CUDA, and have been using it for a couple of years on LittleGolem [https://www.littlegolem.net/] under the MyKatBot username.  I have been unable to build with TensorRT because I cannot install TensorRT -- I could use some pointers on this. My main machine has 2 large nVidia GPUs.
+As of July 2026, I have built with CUDA, and have been using it for a couple of years on LittleGolem [https://www.littlegolem.net/] under the MyKatBot username.  I have been unable to build with TensorRT because I cannot install TensorRT -- I could use some pointers on this (my username here is 4Dummies). My main machine has 2 large nVidia GPUs.
 ==== TENSORRT ====
 I have not yet been able to build with the TENSORRT backend.

@@ Line 36: / Line 36: @@
 I have not yet been able to build with the CUDA backend.
-As of July 2026, I have built with CUDA, and have been using it for a couple of years on LittleGolem under the MyKatBot username.  I have been unable to build with TensorRT because I cannot install TensorRT -- I could use some pointers on this. My main machine has 2 large nVidia GPUs.
+As of July 2026, I have built with CUDA, and have been using it for a couple of years on LittleGolem [https://www.littlegolem.net/] under the MyKatBot username.  I have been unable to build with TensorRT because I cannot install TensorRT -- I could use some pointers on this. My main machine has 2 large nVidia GPUs.
 ==== TENSORRT ====
 I have not yet been able to build with the TENSORRT backend.

@@ Line 35: / Line 35: @@
 ==== CUDA ====
 I have not yet been able to build with the CUDA backend.
 ==== TENSORRT ====
 I have not yet been able to build with the TENSORRT backend.

@@ Line 1: / Line 1: @@
-There is more than one version of KataHex out there, so these instructions have variants
+This page contains detailed instructions for building the [[KataHex]] software from source code. KataHex is a free and open-source computer Hex program. For general information about KataHex, see [[KataHex|the main KataHex page]].
 ----
@@ Line 12: / Line 14: @@
 You may have to install additional software to work with KataHex, using <code>apt-get</code> or <code>synaptic</code> to install packages.
-For example, the TCMALLOC option protects from problems related to memory management when you run more than one instance at at time.  You may have to install one or more packages
+For example, the TCMALLOC option protects you from problems related to memory management when you run more than one instance at at time.  You may have to install one or more packages.
 * <code>libtcmalloc-minimal4t64</code>
 * <code>librust-tcmalloc-dev</code>
 * <code>librust-tcmalloc-sys-dev</code>
-The code works with at least 4 backends (software where the real work is done), EIGEN, OPENCL, CUDA, AND TENSORRT
+The code works with at least 4 backends (software where the real work is done), EIGEN, OPENCL, CUDA, AND TENSORRT. Which of these backends you should choose depends on what hardware you own. If you do not have a GPU, use the EIGEN backend.
 ==== EIGEN (CPU only) ====
 The following BASH commands then may do the trick, but will produce code that may only work on the exact CPU model you use for the build.  See comments in the KataHex source code, as well as the KataGo source code (on with KataHex is based, and which contains more details).
@@ Line 30: / Line 31: @@
 ==== OPENCL ====
-You may be able to use almost  the same commands as for EIGEN, just by changing to -DUSE_BACKEND=OPENCL
+You may be able to use almost  the same commands as for EIGEN, just by changing to -DUSE_BACKEND=OPENCL.
 ==== CUDA ====
-I have not yet been able to build with the CUDA backend
+I have not yet been able to build with the CUDA backend.
 ==== TENSORRT ====
-I have not yet been able to build with the TENSORRT backend
+I have not yet been able to build with the TENSORRT backend.

@@ Line 8: / Line 8: @@
 </pre>
-You may have to install additional software to work with KataHex, using <code>apt-get</code> or <code>synaptic</code> to install packages.
+This creates a katahex directory wherever you execute that command.  If you want to build multiple variants, you will have to do a separate load for each one
 For example, the TCMALLOC option protects from problems related to memory management when you run more than one instance at at time.  You may have to install one or more packages
 * <code>libtcmalloc-minimal4t64</code>

← Older revision	Revision as of 16:34, 25 January 2026
(No difference)

@@ Line 15: / Line 15: @@
 * <code>librust-tcmalloc-sys-dev</code>
-The code works with at least 4 backends (software where the real work is done), EIGEN, CUDA, OPENCL AND TENSORRT.
+The code works with at least 4 backends (software where the real work is done), EIGEN, OPENCL, CUDA, AND TENSORRT
 ==== EIGEN (CPU only) ====
@@ Line 23: / Line 23: @@
 <pre>
-  cmake . -DUSE_BACKEND=EIGEN -DUSE_AVX2=1 -DUSE_TCMALLOC=1 -DCMAKE_CXX_FLAGS='-march=native'
+  cmake . -DUSE_BACKEND=EIGEN -DUSE_AVX2=1 -DUSE_TCMALLOC=1 -DCMAKE_CXX_FLAGS='-march=native' -DMAX_BOARD_LEN=19
   make -j 4
 </pre>
 ==== CUDA ====
@@ Line 32: / Line 35: @@
 ==== TENSORRT ====
 I have not yet been able to build with the TENSORRT backend

@@ Line 4: / Line 4: @@
 == Ubuntu Linux ==
 You may have to use <code>apt-get</code> or <code>synaptic</code> to install packages
 ==== EIGEN (CPU only) ====
 The following BASH commands then may do the trick, but will produce code that may only work on the exact CPU model you use for the build.  See comments in the KataHex source code, as well as the KataGo source code (on with KataHex is based, and which contains more details).