shahmat 0.1.0

Analyze your Chess.com games: fetch, stats (hour, Elo diff, opening), and clean visualizations.

ShahMat

ShahMat is a Python package that leverages the official Chess.com API to fetch, analyze, and visualize your games.
It is part of the AG Algo Lab initiative: making finance & tech accessible to everyone — and yes, sometimes we have fun applying data science to chess too!

The name ShahMat comes from the ancient expression that later gave birth to the word “checkmate” :)

---

Features

• Fetch games directly from Chess.com using a single function

• Analyze performance (through Visualizations) by:

  • Hour of the day
  • Number of games per day
  • Elo difference vs opponents
  • Color (White / Black)
  • Opening (first move played)
  • Result type breakdown (Wins, Losses, Draws)

• Download: export your data in a csv file

---

Quick Start

Install & Use ShahMat:

pip install ShahMat

chesscom('your_username', start_year=2024)