Igel is a free UCI chess engine forked from GreKo 2018.01. It is not a complete chess program and requires some UCI compatible GUI software in order to be used.
Igel started as a hobby project in early 2018 to learn chess programming. The name 'Igel' is a German translation of 'Hedgehog' and was chosen to represent numerios hedgehogs living in my garden.
Igel was forked from GreKo 2018.01 and the main reason for the fork was to study the existing chess engine and improve its strength over time and learn new things. GreKo was chosen because it had a clean code, it supported Visual Studio and it was not a very strong engine so further improvements would be possible.
The first versions of Igel were actually regressions and had less strength than the original version of GreKo that were used to fork Igel. After trying a few things and lacking any experience in chess engine development the work on Igel was halted by late 2018.
In March 2019 Igel was invited to a prestigious chess tournament for top chess engines - TCEC to participate in season 15 and it took last place in Division 4a. Seeing poor performance of Igel it was a great motivation factor to improve the engine and active development work has begun. By late 2019 Igel had surpassed 3000 elo in CCRL Blitz and entered the top 50 engines in CCRL list.
By mid 2020 Igel 2.5.0 64-bit 4CPU reached 3245 elo in CCRL Blitz on 4CPU and entered the top 30 engines of the list.
In June 2020 Igel was invited by Andrew Grant to participate in OpenBench testing framework and this has further accelerated the strength improvement of the engine. In August 2020 Igel switched to NNUE as a main evaluation function using Dietrich Kappe's NiNu network file and is currently approaching the top ten strongest chess engines on CCRL list.
In October 2020 first Igel Generation Networks were introduced seeing participation of Igel in TCEC Cup7 and TCEC Season 20 and released later with Igel 2.9.0.
In January 2023 last bits of HCE code were removed from Igel and the evaluation is fully based on NNUE as of Igel 3.4.0.
Igel Generation Networks (IGN)
In late 2020 there have been a lot of discussions in the chess community about NNUE techology in general and NNUE networks in particular raising important questions about authenticity of networks.
I have decided to dedicate time and resources to create my own class of networks that will be used for future Igel releases: Igel Generation Network (IGN).
The IGN networks comply with the following mandatory requirements:
Source of network data: evaluation, search, pv line is generated solely using Igel chess engine. As a starting point Igel 2.6.0 is choosen as this was the last version of Igel featuring HCE (Hand Crafted Evaluation)
Both data and validation data generation must be following the rule #1
Two versions of Igel: 2.7.0 and 2.8.0 are excluded from network training/data generation process (both for data and for validation data) because they use Dietrich Kappe's Night Nurse network as thus violate the rule #1
Data generation and network training must be done by myself on my own (or rented by me) hardware in order to make sure the rule #1 is not violated
Each generation of network must contain information (on github page) on training parameters for clarity of the source of data
|Generation||Architecture||Source of data||Quantity||Data Type||Best network|
|ign-0||halfkp_256x2-32-32||Igel 2.6.0||2.3b d8, 500m d12||HCE||ign-0-9b1937cc|
|ign-1||halfkp_256x2-32-32||Igel 2.6.0, Igel 2.9.0, Igel 3.0.0||12b d8, 1b d12||HCE, NNUE||ign-1-9a48854b|
|ign-2||halfkav2_512x2-16-32||Igels as of 2.9.0||d5+d8+d16 >30b||Mostly NNUE||ign-2-51ba2968|
|ign-3||halfkav2_hm_1024x2-8-32||Igels as of 2.9.0||d5+d8+d16 >30b||Fully NNUE||ign-3-debc71a4|
I would like to thank the authors and the community involved in the creation of the open source projects listed below. Their work influences development of Igel, and without them, this project wouldn't exist. Special thanks to Andrew Grant and Bojun Guo for supporting Igel development on OpenBench.
- Chess Programming Wiki
- Dietrich Kappe for creating Night Nurse network and allowing it to use in Igel 2.7.0 and 2.8.0 releases
- Dietrich Kappe for sharing his knowledge/tooling for NNUE networks training
- Yu Nasu for creating NNUE and Hisayori Noda and others for integrating it in Stockfish
Official compilation method involves cmake and gcc/Visual Studio 2019 and assumes a modern CPU with AVX2 support (most of the computers produced in last 8 years).
Using cmake/Visual Studio 2022:
git clone https://github.com/vshcherbyna/igel.git ./igel cd igel git submodule update --init --recursive cmake -DUSE_AVX2=1 -D_BTYPE=1 -DSYZYGY_SUPPORT=TRUE -G "Visual Studio 17 2022" -A x64 .
git clone https://github.com/vshcherbyna/igel.git ./igel cd igel git submodule update --init --recursive wget https://github.com/vshcherbyna/igel/releases/download/3.4.0/ign-3-debc71a4 -O ./network_file cmake -DEVALFILE=network_file -DUSE_PEXT=1 -DUSE_AVX2=1 -D_BTYPE=1 -DSYZYGY_SUPPORT=TRUE . make -j
Important! If you make a custom build of Igel you need to validate the bench using command:
or if you are running Linux:
The 'Nodes' must match the 'BENCH :' value from the last commit message.
It is also possible to compile using gcc and a traditional makefile, please consult ./src/makefile for more details.
Thank you so much for supporting Igel's development and training via .