Skip to main content

Making chess analytics easy.

Project description

Chess-Analytica: Simplifying Chess Analytics

Introduction

Chess-Analytica is a powerful chess library designed for effortless data scraping and analysis. Utilizing the chess.com 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 chess.com 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

# Initialize and filter games
profile = ChessDotCom.Profile("aronfrish", False)
profile.filterGameType("rapid")

# Analyze game terminations
resignation_count = sum(1 for game in profile.games if "resignation" in game.termination)
print(f"Rapid games ended in resignation: {resignation_count}")

# Analyze specific openings
italian_games = profile.find_games_with_FEN_and_Color("r1bqkbnr/pppp1ppp/2n5/4p3/2B1P3/5N2/PPPP1PPP/RNBQK2R", True)
italian_game_percentage = len(italian_games) / len(profile.white_games)
print(f"Italian games percentage (as white): {italian_game_percentage:.2%}")

Installation

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 <https://chess-analytica.readthedocs.io/en/latest/>_
  • Usage Examples: Examples <https://chess-analytica.readthedocs.io/en/latest/usage.html>_
  • API Reference: ChessDotCom Class <https://chess-analytica.readthedocs.io/en/latest/chessdotcom.html>_ | Board Class <https://chess-analytica.readthedocs.io/en/latest/board.html>_

License

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

Uploaded Source

Built Distribution

chess_analytica-1.1.7-py3-none-any.whl (11.0 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