GitLocker: The Coding Marketplace

Description:

AIChess 2.0.8

AI-Chess
Basic chess features that includes an AI for decision making in Python
Install Guide
To install packages run in terminal (Python 3.9+):
pip install AI-Chess

Quick Tutorial
To start the board and the AI, do the following:
>>> from AIchess import *

>>> aic = AIChess()

If you want to take a look at the board do this:
>>> print(aic.board)

If you want to get the board as a 2D list for easy use and print each row do this:
>>> [print(sub_list) for sub_list in aic.get_boardAs2DList()]

If you want to get the board as a flipped 2D list for easy use with white on top and black on bottom but with chess notation like 'a1' still being on white then print each row do this (Extra functions to support this board exist in documentation like automatically flipping the row and col to support this):
>>> [print(sub_list) for sub_list in aic.get_boardAs2DListFlipped()]

If you want change the AI algorithmic minimax depth to a higher number for better accuracy at the cost of computational requirement do this (Default: 3; Needs to be greater than 0):
>>> aic.minimaxDepth = 2

If you want to use the minimax AI to get one of the best possible moves for whoevers turn it is and use that move on the board then print the board do this (This assumes that the game isn't over for any reason):
>>> aic.makeChessMove(aic.chessAIMove()[0])

>>> [print(sub_list) for sub_list in aic.get_boardAs2DList()]

Documentation
__init__()

Initialize the library by creating board: chess.Board which is the starting chess board in the chess library, it is public for you to use however be careful as you can break some functions and minimaxDepth: int which is the depth of the search algorithm. Higher the better but requires move computational power. Single process and needs to be > 0. Default 3.
chessAIMove() -> List[str]

Returns a list of the best possible legal_moves for whoevers turn it is in UCI however, it is possible that one or more of the entries can be the string 'claim_draw' instead of a UCI which is to indicate the desire to claim a draw like FIFTY_MOVES or THREEFOLD_REPETITION
get_whiteBlackPointsDifference(game: chess.Board) -> int

Returns the point difference between white and black where Pawn: 1, Bishop: 3, Knight: 3, Rook: 5, Queen 9
makeChessMove(uci: chess.Move | str) -> None

Needs to be at least pseudo_legal
listAllPossibleMoves() -> List[Move]

Lists all possible legal_moves for whoevers turn it is for each piece
listUCIPosPossibleMoves(uciPos: str) -> List[Move]

Lists all possible legal_moves for whoevers turn it is for the uciPos like 'a2', or 'b1'
Returns an empty List if no possible moves
reset() -> None

Resets board in chess.Board
willMoveNeedPawnPromotion(uci: chess.Move | str) -> bool

Return True if move will result in a pawn promotion, False otherwise
pieceToPieceType(result: chess.Piece | str) -> int

Return chess.PieceType as a int
rowColToUCI(rowColFrom: list[int], rowColTo: list[int]) -> str

Accepts two List[int] which is the row and col from and to locations
Returns a str which is a uci representing the inputs
uciToRowCol(uci: chess.Move | str) -> List[int], List[int]

Accepts a str which is a uci
Returns two List[int] which are the row and col from and to representing the inputs
rowColToUCIPos(row: int col: int) -> str

Accepts a row and col of a 2D list that is the chess board
Returns a uciPos which is a single position like a2 or b1 representing the inputs
uciToRowColPos(uciPos: str) -> int, int

Accepts a uciPos which is a single position like a2 or b1
Returns a row and col of a 2D list that is the chess board representing the inputs
uciToFlippedRowCol(uci: chess.Move | str) -> List[int], List[int]

Accepts a uci
Returns two List[int] which are the row and col from and to in a 2D list that is the chess board representing
the inputs but flipped so that white is on top and black is bottom
flippedRowColToUCIPos(row: int, col: int) -> str

Accepts a row and col position that has been flipped so that white is on top and black is on bottom
Returns a uciPos which is a single position like a2 or b1 representing the inputs
uciToFlippedRowColPos(uciPos: str) -> int, int

Accepts a uciPos which is a single position like a2 or b1
Returns a row and col position that has been flipped so that white is on top and black is on bottom representing the inputs
flipRowCol(rowColFrom: list[int], rowColTo: list[int]) -> List[int], List[int]

Accepts two List[int] which is the row and col from and to locations
Returns two List[int] which is the row and col from and to locations but flipped so that white is one top and black is on bottom
flipRowColPos(row: int, col: int) -> int, int

Accepts two int which is the row and col for a location
Returns two int which is the row and col for a location but flipped so that white is one top and black is on bottom
get_boardAs2DList() -> List[int][int]

Returns a 2D list that represents the chess board with white on bottom and black on top for easy use
get_boardAs2DListFlipped() -> List[int][int]

Returns a 2D list that represents the chess board but flipped so white is on top and black is on bottom for easy use
get_isWhiteTurn() -> bool

Returns a bool where True is if it is white's turn and False if it is black's turn
get_isStartOfGame() -> bool

Returns a bool where True is if it is the start of the game and False if it isn't
Extra
For more information on how to use this project visit https://python-chess.readthedocs.io/en/latest/ where some of this project uses.