The following project is a Big Chess Analysis using the chess.com API and API Wrapper.
This project is open-source on Github, with published docs at Documentation.
Looking to contribute? Visit CONTRIBUTING for more details.
Learn more about the community of players you or your opponent's are part of in Chess.com! Deep-dive into the chess.com network and identify & report unusual anomalies in games or players!
This project enables an interactive graph of chess.com players, pulling player and game data along the way to analyze and identify anomalies.
Deep dive analysis approaches can be found in notebooks/
.
No installation required! Simply visit our site and start exploring.
If local install is preferred:
poetry
is highly recommended. Follow Poetry Installation for installation.poetry install
to install & create a local virtual environment for the project.- Alternatively, a
requirements.txt
is generated forpip
.
- Alternatively, a
Execution not required! Simply visit our site and start exploring.
If local execution is preferred:
poetry
is highly recommended to enablepoetry run
.- Alternatively, leverage
requirements.txt
&python -m venv
.
- Alternatively, leverage
make serve-dev
to launch the webapp on localhost (using Dash) -- Alternativelypoetry run python dashapp/main.py
-- Alternativelymake serve
to launch with gunicorn on 127.0.0.1:8080
Visit our site to get started. There you will be greeted with inputs: Username, Date, and Depth. Please input a chess.com username to begin (modify date and depth to your preference).
Easter-Egg: You can skip the inputs and simply generate the graph right away!
Once the graph is loaded, you're welcome to click on graph'ed nodes, and explore the space further.
If struggling to find good inputs. This project was tested using:
- Username: fabianocaruana
- Year: 2024
- Month: 10
- Depth: 3 (Optional)
Analytics of the graph is generated live as the graph adapts. Review the analytics, and consider reporting anomalies to chess.com!
More in-depth approaches can be found in notebooks
.