Skip to main content

Making chess analytics easy.

Project description

PyPI Downloads Docs License Status Tests


Chess-Analytica is a chess library that allows for the simple scraping of data using the API, and subsequent analysis of that data. Built on top of the python-chess library, Chess-Analytica allows for you to easily scrape all of a given player’s past (or current) games, filter the games down, and then analyze them.

from chess_analytica import Board, ChessDotCom

profile = ChessDotCom.Profile("aronfrish", False)


print(len( #720

n = 0
for game in : #Note: this is still filtered to rapid
if ("resignation" in game.termination) :
    n += 1
print(n) #Note: this will print the number of the player's rapid games that ended in resignation

italian_games = profile.find_games_with_FEN_and_Color("r1bqkbnr/pppp1ppp/2n5/4p3/2B1P3/5N2/PPPP1PPP/RNBQK2R", True) #Note: this FEN is the italian game and the target player color is white (because is_white is set to True)
print(len(italian_games)/len(profile.white_games)) #Note: this will print the percentage of rapid games (where the player is white) that the player has played the italian game


Download and install the latest release:

pip install chess-analytica



  • Scrape all game info from a given player’s profile

  • Simulate games and analyze them

  • Filter games by time control


Chess-Analytica is licensed under the MIT License. Check out LICENSE.txt for the full text.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chess-analytica-1.2.1.tar.gz (12.2 kB view hashes)

Uploaded Source

Built Distribution

chess_analytica-1.2.1-py3-none-any.whl (11.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page