chessx 0.2.0

Description:

chessx 0.2.0

python-chessx
A chess XAI program







Introduction
Dependencies
Features
Tests

1. Introduction
python-chessx is an explainable chess AI that generates commentary for positions/moves in a game of chess.
2. Dependencies

Python3 - Download and Install Python3. You can also use your system's package manager to install the latest stable version of python3.
For dev work, run the following commands (preferrably in a virtual environment):

pip install -e .

3. Features

Provides a utility to generate explanations from a FEN representation of a chess position.

Piece Square Tables

import chessx.heuristic as heuristic
import chess

psqt_fen = 'rn2kb1r/pp2qppp/2p2n2/4p1B1/2B1P3/1QN5/PPP2PPP/R3K2R b KQkq - 1 9'
psqt_util=heuristic.PSQT(psqt_fen)

# generate list of explanations
exp_list=psqt_util.get_explanations()

# print explanations
print('PSQT Explanations:')
for exp in exp_list:
print(exp)


Trapped Pieces

tp_fen='r5k1/p4p1p/2p3pb/2N1n2n/1p2PP2/1B2B1PP/PP4K1/3R4 b - - 0 24'
tp_util=heuristic.TrappedPieces(tp_fen)

# generate list of explanations
exp_list=tp_util.get_explanations()

# print explanations
print('Trapped Pieces Explanations:')
for exp in exp_list:
print(exp)


Pinned Pieces

pin_fen='1rk5/8/4n3/5B2/1N6/8/8/1Q1K4 b - - 0 1'
pin_util=heuristic.PinnedPieces(pin_fen)

# generate list of explanations
exp_list = pin_util.get_explanations()

# print explanations
print('PinnedPieces Explanations:')
for ex in exp_list:
print(ex)
print()



3. Tests
The following command to runs unit tests on the project:
pytest