chess_insight

Modern application for gathering chess data and analyzing chess games.

Features:

1. Download games from lichess.org and chess.com
2. Analyze games using set of custom methods and stockfish-16 engine.
3. Parses games to Game object which contains all information about game and players to python object and json.
4. Provides method for exporting list of analyzed games to csv

interactive mode

installation

1. pip install chess_insight # download application
   

2. [Optional] Download stockfish-16 from here

3. python -m chess_insight # run app
   

Now answer questions and have fun with csv or json data

Python module

pip install chess_insight

[Optional] Download stockfish-16 from here

Usage

• get games

from chess_insight import ChessComApiCommunicator, LichessApiCommunicator

c1 = LichessApiCommunicator("path/to/stockfish")
c2 = ChessComApiCommunicator("path/to/stockfish" # if blank stocfish wont be used
)

games = list(c1.games_generator("your lichess username", 10, "blitz"))
games += list(c2.games_generator("your chess com username", 10, "blitz"))

• export games to csv

chess_insight.export_games_to_csv(list(games))

CSV

• get games as dict

for game in games:
    print(game.asdict())

json

{
    "date": datetime.datetime(2023, 9, 14, 21, 57, 47),
    "host": "chess.com",
    "opening": "Sicilian Defense: Closed, Traditional",
    "opening_short": "Sicilian Defense",
    "opponent": {
        "avg_move_time": {"opening": 1.2, "middle_game": 5.1906, "end_game": 3.9467},
        "elo": 1603,
        "evaluation": {
            "opening": {"inaccuracy": 1, "mistake": 1, "blunder": 1},
            "middle_game": {"inaccuracy": 13, "mistake": 13, "blunder": 15},
            "end_game": {"inaccuracy": 6, "mistake": 7, "blunder": 7}
        }
    },
    "phases": {"opening": 4, "middle_game": 64, "end_game": 91},
    "player": {
        "avg_move_time": {"opening": 1.65, "middle_game": 3.4875, "end_game": 3.0109},
        "elo": 1619,
        "evaluation": {
            "opening": {"inaccuracy": 0, "mistake": 0, "blunder": 0},
            "middle_game": {"inaccuracy": 1, "mistake": 1, "blunder": 1},
            "end_game": {"inaccuracy": 1, "mistake": 1, "blunder": 1}
        }
    },
    "player_color": "white",
    "result": ["white", "timeout"],
    "time_class": "blitz",
    "time_control": "180+0",
    "url": "https://www.chess.com/game/live/88467619273",
    "username": "barabasz60"
}

Architecture

Game object

Player object

• example game:

Example charts (Code can be found in here)