chipiron 0.1.9

chipiron plays chess

Chipiron

Chipiron is a Python library that plays chess

Acknowledgments

This code is build on top of the chess library https://github.com/niklasf/python-chess and its rust version :https://github.com/niklasf/shakmaty

It also integrates code from : https://github.com/oakmac/chessboardjs/

Play Online against Chipiron

Play at this website !

Requirements

• Python 3.12
• pip
• curl
• tkinter
• make

Installation

Make

The following command will install the python packaged listed in requirements.txt, download syzygy tables, install stockfish, retrieve datasets and gui images...

make init

so you might want to git clone and create a virtual environment as follows:

Click here to see more detailed instructions with conda

git clone https://github.com/victorgabillon/chipiron.git
cd chipiron
conda create --name chipiron3.12 python==3.12
`conda activate chipiron3.12
`conda install -c conda-forge tk=*=xft_*
make init

Docker

To build the docker:

docker build -t chipiron-x11 .

To run the docker with GUI:

sudo docker run --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  --network=host \
  -u $(id -u):$(id -g) \
  chipiron-x11

Usage

Base case with a GUI to play against chipiron or watch it play

Starts a gui to choose your options of play.

python3 chipiron/scripts/main_chipiron.py

Other Scripts:

One match:

This allows to play a match between two players.

python3 chipiron/scripts/main_chipiron.py --script_name one_match --config_file_name chipiron/scripts/one_match/inputs/base/exp_options.yaml

League

This allows to run a league of selected players and compute their Elo ratings.

python3 chipiron/scripts/main_chipiron.py --script_name league

Lean a NN from a labelled dataset

This learns Neural Networks from a database of labelled boards.

python3 chipiron/scripts/main_chipiron.py --script_name learn_nn --config_file_name chipiron/scripts/learn_nn_supervised/exp_options.yaml

Contributing

License

GPL-3.0