Skip to main content

Making chess analytics easy.

Project description

Chess-Analytica: Simplifying Chess Analytics


Chess-Analytica is a powerful chess library designed for effortless data scraping and analysis. Utilizing the API, it builds upon the robust python-chess library, enabling users to scrape and analyze past or current games of any player with ease.

Key Features:

  • Easy scraping of game data from profiles.
  • Advanced game filtering options.
  • Comprehensive analysis of game patterns and styles.

Quick Start

Here's a glimpse of what you can do with Chess-Analytica:

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


Easily install Chess-Analytica using pip:

pip install chess-analytica

Documentation and Resources

Explore detailed documentation and examples to get the most out of Chess-Analytica:

  • Documentation: Full Documentation <>_
  • Usage Examples: Examples <>_
  • API Reference: ChessDotCom Class <>_ | Board Class <>_


Chess-Analytica is open-sourced and available under the MIT License. For more details, see LICENSE.txt.

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.1.8.tar.gz (12.0 kB view hashes)

Uploaded Source

Built Distribution

chess_analytica-1.1.8-py3-none-any.whl (11.1 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