Instructions for JetPack 4.6 are presented below. If you run into any problems, see the Troubleshooting section. You can find a list of the python packages required in the requirements.txt file.

1. Install tensorflow for Jetson Nano:

   sudo apt-get update
   sudo apt-get install -y python3-pip pkg-config
   sudo apt-get install -y libhdf5-serial-dev hdf5-tools libhdf5-dev zlib1g-dev zip libjpeg8-dev liblapack-dev libblas-dev gfortran
   sudo ln -s /usr/include/locale.h /usr/include/xlocale.h
   sudo pip3 install --verbose 'protobuf<4' 'Cython<3'
   sudo wget --no-check-certificate https://developer.download.nvidia.com/compute/redist/jp/v461/tensorflow/tensorflow-2.7.0+nv22.1-cp36-cp36m-linux_aarch64.whl
   sudo pip3 install --verbose tensorflow-2.7.0+nv22.1-cp36-cp36m-linux_aarch64.whl

2. Install ONNX Runtime

   Download the .whl file from here and run

   sudo pip3 install onnxruntime_gpu-1.8.0-cp36-cp36m-linux_aarch64.whl

3. Install OpenCV 4.5 with CUDA enabled. To do so, download and execute this script. Warning: this process will take some time and you may need to increase the swap space with jtop.

4. If you plan on converting ONNX models to TensorRT, add the following lines to the .bashrc file to access trtexec:

   export PATH=$PATH:/usr/src/tensorrt/bin

   Then, you can run trtexec --onnx=model.onnx --saveEngine=model.trt to convert an ONNX model to a TensorRT engine.

5. Install the rest of the required packages:

   sudo pip3 install -r requirements.txt

Utilities

• You can also install jtop to monitor the usage of the Jetson Nano. To install, run

  sudo pip3 install -U jetson-stats

  and reboot the Jetson Nano. You can execute it by running jtop.

Troubleshooting

• To upgrade CMake, download CMake 3.14.7 and run

  tar -zxvf cmake-3.14.7.tar.gz
  cd cmake-3.14.7
  sudo apt-get install libcurl4-openssl-dev
  sudo ./bootstrap
  sudo make
  sudo make install
  cmake --version

• To install protobuf download protobuf 3.17.3 and run

  tar -zxvf protobuf-cpp-3.17.3.tar.gz
  cd protobuf-3.17.3
  ./configure
  make
  sudo make install
  sudo ldconfig

• If you get the error ImportError: /usr/lib/aarch64-linux-gnu/libgomp.so.1: cannot allocate memory in static TLS block, run

  export LD_PRELOAD=/usr/lib/aarch64-linux-gnu/libgomp.so.1

  In order to permanently fix the error, add that line to the end of your ~/.bashrc file.

• If you get the error Illegal instruction (core dumped), run

  export OPENBLAS_CORETYPE=ARMV8

  In order to permanently fix the error, add that line to the end of your ~/.bashrc file.

• If you get the error error: command 'aarch64-linux-gnu-gcc' failed with exit status 1, run

  sudo apt-get install python3-dev

• If you cannot install pycuda because it doesn't find cuda.h, run

  export CPATH=$CPATH:/usr/local/cuda-10.2/targets/aarch64-linux/include
  export LIBRARY_PATH=$LIBRARY_PATH:/usr/local/cuda-10.2/targets/aarch64-linux/lib

  In order to permanently fix the error, add those lines to the end of your ~/.bashrc file.

• In any case, if you find that there is a library missing, you can try to install it using pip or google how to install it on the Jetson Nano.

Installation instructions for Ubuntu (22.04) are presented below. Other Linux distributions should be similar.

1. First clone the repository and cd into it:

   git clone https://github.com/davidmallasen/LiveChess2FEN.git
   cd LiveChess2FEN

2. Create a python virtual environment, activate it and upgrade pip:

   python -m venv venv
   source venv/bin/activate
   pip install --upgrade pip

   You will have to activate the virtual environment every time you want to use LiveChess2FEN.

3. Install the required python packages:

   pip install -r requirements_pc.txt

   This should include the following packages:

   • NumPy
   • OpenCV4
   • Matplotlib
   • Scikit-learn
   • Pillow
   • Pyclipper
   • Tqdm

   Also, depending on the inference engine you want to use, install the following dependencies:

   • Keras with tensorflow backend.
   • ONNX Runtime.
   • (Optional) TensorRT and PyCUDA.

Installation instructions for a Windows computer are presented below.

1. First, install Python 3.10 from Microsoft Store. It is important NOT to install Python 3.11 instead as it would create dependency (numpy) issues when we later install onnxruntime and tensorflow==2.12.0.

2. Then make sure your pip is up to date by running the following command in Windows PowerShell:

   pip install --upgrade pip

3. If you see any warning about some directory not on PATH, follow this and restart the computer to resolve it.

4. In order to successfully install tensorflow, you need to first enable long paths. To do so, open another PowerShell as administrator and run the following command:

   New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
   

5. Now you can install all the relevant packages by running the following commands in Windows PowerShell:

   pip install numpy
   pip install opencv-python
   pip install chess
   pip install tensorflow==2.12.0
   pip install onnxruntime
   pip install matplotlib
   pip install pyclipper
   pip install scikit-learn
   pip install tqdm
   pip install pandas
   pip install onnx
   pip install tf2onnx
   pip install pytest

   Note: the above commands would install all the latest-possible versions of the required packages (it was found that there might not be any restrictions on the versions of nontensorflow packages). Alternatively, you could use the "requirements_pc.txt" file (pip install -r requirements_pc.txt) to install the specific versions that have been tested to be 100% working.

6. Finally, in order to successfully import tensorflow, you also need to install a Microsoft Visual C++ Redistributable package from here. If you are using Windows 11 (Windows 11 only has the 64-bit version), you can simply download and install this.