♘ Lichess ASCII rating generator

Generates ASCII charts of lichess ratings.

Example:

          _      _      _
         | |    (_)    | |
         | |     _  ___| |__   ___  ___ ___
         | |    | |/ __| '_ \ / _ \/ __/ __|
         | |____| | (__| | | |  __/\__ \__ \
         |______|_|\___|_| |_|\___||___/___/

    2130 ┤                                                              ╭
    2042 ┤                                                              │
    1954 ┤                                              ╭╮  ╭╮          │
    1866 ┤                                         ╭╮ ╭─╯╰──╯╰──╮ ╭─────╯
    1778 ┤                           ╭╮  ╭──╮╭──╮╭─╯╰─╯         ╰─╯
    1690 ┤                        ╭╮╭╯╰──╯  ╰╯  ╰╯
    1602 ┼╮                   ╭──╮│╰╯
    1514 ┤│   ╭───╮╭─╮╭╮╭─────╯  ╰╯
    1426 ┤╰╮ ╭╯   ╰╯ ╰╯╰╯
    1338 ┤ ╰─╯
    1250 ┤

User: christopsy666, Rating type: Bullet on lichess.org
Last update: 09.11.2025 14:59:16

Follow me on

Installation

Install the python dependencies via requirements.txt via

pip install -r requirements.txt

and export your lichess API token as environment variables via

export API_TOKEN=your_lichess_api_token

For convenience, put this in you .bashrc

Usage

python3 lichess_ascii_rating_tracker.py -r puzzle_type

where puzzle_type is one of the following:

Bullet, Blitz, Rapid, Classical, Correspondence, Chess960, King of the Hill, Three-check, Antichess, Atomic, Horde, Racing Kings, Crazyhouse, Puzzles, UltraBullet

The output can be piped to a file, but should be enclosed with

<pre>
<code>
generated_output
</code>
</pre>

for Markdown to preserve whitespaces.

Docker

Alternatively, you can use docker compose to generate an ASCII chart.

First, build the image via

cd .docker
docker compose build

and then run it via

docker run -e API_TOKEN=$API_TOKEN lichess-docker:v0.1.0 -r Bullet