Skip to content

Latest commit

 

History

History
48 lines (37 loc) · 2.45 KB

Setup.md

File metadata and controls

48 lines (37 loc) · 2.45 KB

Setting up Ceres

Please note that currently the installation and configuration is somewhat involved. This is expected to be simplified in the future.

Hardware/Software Requirements

  • Windows 10 (a Linux version is under development)
  • Processor based on Intel/AMD x86 architecture
  • Processor support for AVX instruction set
  • At least one NVIDIA GPU with CUDA drivers installed
  • Minimum 8GB of memory (recommended)

Preliminaries

Please follow these preliminary steps (as needed) for installing the Ceres development environment:

Buliding the LC0.DLL

If a pre-built LC0.DLL is not provided or available for the version of CUDA installed on your computer it will be necessary to build from source.

Building Ceres

Now you can launch Visual Studio and open the solution file Ceres.sln under the src directory. For best performance, make sure to choose "Release" from the top toolbar (not "Debug"). You can then run Ceres by "Run without debugging" command (Ctrl-F5.).

Configuring Ceres

The final required step is to make sure a required configuration file with the name Ceres.json is present in the working directory from which Ceres is launched (typically under a subdirectory with name of the form artifacts/release/net5.0). This file contains various configuration entries (some required, some optional).

If Ceres launched run without a Ceres.json file in the working directory, the user will be prompted to enter the values of 4 required configuration settings. These will then be used to initialize a functional Ceres.json file, which can then be customzied at will using a text editor (or the SETOPT command in Ceres).

The following is a complete example of this setup process, followed by a simple UCI search command using the newly configured settings.