metadata

title: Chessli2
emoji: 🏰
colorFrom: blue
colorTo: red
sdk: gradio
app_file: app.py
pinned: true

Welcome to Chessli2 🏰

Chessli2 is your always free and open-source chess trainer 🛡️, designed to elevate your game by allowing you to analyze games, identify mistakes, and sharpen your tactics, all sourced directly from lichess.org.

Why a second version?

Incredibly, despite my prolonged absence, I continue to receive heartfelt 💌 thank you notes and eager requests for chessli. This overwhelming support has inspired me to develop a sleek new version of Chessli that not only squashes all those pesky bugs 🐛 but also introduces a user-friendly graphical interface. This means no programming experience is required to dive in!

Features 🌟

Automatically fetch your games and played tactics puzzles from lichess via the berserk python client for the Lichess API! 🔄
Find your mistakes by parsing and analyzing your games with python-chess 🔍
Leverage the power of spaced repetition using Anki with this amazing interactive chess template: Anki-Chess-2.0 🧠
And everything with a beautiful GUI thanks to gradio

Chessli2 is here to support your journey to becoming a chess master. Dive in and start enhancing your skills today! 🚀

Quickstart

Try it directly out at Huggingface Spaces.

FAQ

🗝️ How to Obtain Your Lichess API Token

:zap: Fast route: Simply click this pre-filled URL for a quick set-up with the correct token space: https://lichess.org/account/oauth/token/create?scopes[]=puzzle:read&description=My+token+for+chessli2

To acquire a personal API token for the Lichess platform, simply follow these steps:

Create a Lichess Account 🆕: If you don't already have one, create a Lichess account by visiting lichess.org and signing up.
Log In 🔑: After setting up your account, log in and navigate to your account settings.
Access Token Settings 🔧: Proceed to the 'API Access Tokens' section, typically found under a menu related to tools or personal settings. You can directly access it via https://lichess.org/account/oauth/token.
Create a New Token 🆕: Click on the button to create a new token. You'll need to specify the scopes or permissions that the token should have. These permissions determine what actions your token can perform on your behalf. For chessli2 it is currently sufficient to permit "Read Puzzle Activity" and "Read Preferences".
Name Your Token 🏷️: Assign a meaningful name to your token for easy identification, especially useful if managing multiple tokens.
Generate the Token 🔄: After selecting the necessary scopes and naming your token, click to generate it. Lichess will display your new API token.
Copy and Secure Your Token 🔒: Ensure you copy and securely store your token. Do not share it, as it grants access to your Lichess account based on the selected scopes. Remember, Lichess will not display the token again once you navigate away from the page.
Use the Token 🚀: You can now use this token by pasting it into the "Lichess API token" field within the chessli2 interface

🚨 Important: If your token is ever compromised or no longer needed, revoke it immediately to secure your account.

📚 How to Get Anki Cards from My Mistakes?

📄 Create a CSV File

After you've fetched your mistakes with chessli2, a "Download CSV" button will appear.
Click this button and store the CSV file at a location of your choosing.

🛠 Set-up Anki-Chess-2.0

Next, you will need to set up Anki-Chess-2.0. This is the Anki chess template that is needed to visualize your mistakes within Anki with a beautiful interactive chess board.
While you are there, why not leave a star ⭐ to show the maintainer that you value the chess template, or send a nice message? 😊 Since the beginnings of chessli, the chess template has always been a crucial part!

📥 Import the CSV into Anki

Finally, you can import the CSV file into Anki.

Launch the Anki application on your computer.
Choose or create the deck into which you want to import the CSV file.
Click on the deck name to open it.
In the main Anki window, go to the menu bar and click on File.
Select Import... from the dropdown menu.
Browse to the location of your CSV file, select it, and click Open.
Anki will open a dialog box asking how you want to import the CSV file. Select the Chess-2.0 note type.
Make sure it reads: "Field 1 of file is: mapped to PGN"
Click the Import button. Anki will process the file and add the new cards to the selected deck.
After importing, it’s a good idea to review a few cards to ensure they were imported correctly. You can do this by browsing the deck or starting a study session.
Pat yourself on the back! You did it! 🎉