abhinav7sinha / python-chessx

A chess XAI program

python-chessx

A chess XAI program

1. Introduction
2. Dependencies
3. Features
4. 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.
  1. 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)

  2. 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)

  3. 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

python-chessx's Issues

Implement logic for evaluating different pieces

Define an interface/abc for heuristics

All the different heuristics should follow the same structure

• read about interfaces and abstract classes and choose which one works here
• implement

Implement logic for evaluating Pinned Pieces

Implement logic for evaluating Space

Implement logic for evaluating material

Implement logic for evaluating Center Control

Implement logic for evaluating Pawn Structure

Code coverage implementation

Write readme

Write test cases

Implement logic for evaluating Piece-Square Tables

piece-square tables chessprogramming aritcle

• Most modern chess engines use 2 sets of piece square tables - one for opening and one for endgame.
• But how do we identify if a position is from the opening phase or the endgame phase?

Implement logic for evaluating Connectivity

Implement logic for evaluating Tempo

Create program layout

Implement logic for evaluating King Safety

• chessprogramming's article on King Safety

Implement logic for evaluating Trapped Pieces

Implement logic for evaluating Mobility