https://github.com/pwenker/chessli
A free and open source chess improvement app that combines the power of Lichess and Anki.
https://github.com/pwenker/chessli
anki chess lichess python
Last synced: about 1 month ago
JSON representation
A free and open source chess improvement app that combines the power of Lichess and Anki.
- Host: GitHub
- URL: https://github.com/pwenker/chessli
- Owner: pwenker
- License: mit
- Created: 2021-01-15T16:02:11.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-05T10:26:55.000Z (12 months ago)
- Last Synced: 2025-03-11T07:16:53.229Z (about 1 month ago)
- Topics: anki, chess, lichess, python
- Language: Python
- Homepage: https://pwenker.com/chessli
- Size: 4.01 MB
- Stars: 117
- Watchers: 7
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
- Support: docs/support.md
Awesome Lists containing this project
README
🚀 **Chessli v2 is on the Horizon!** 🚀
Incredibly, despite my prolonged absence, I continue to receive heartfelt 💌 *thank you notes* and eager requests for this tool. 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!
~~I'm aiming to wrap up this exciting update in the next couple of weeks. Stay tuned for an announcement 📢 right here as soon as it's ready to launch. 😊~~
📢📢 Update: Chessli2 is up-and-running! Head over to https://github.com/pwenker/chessli2/ and try it out! 📢📢
_A free and open-source chess improvement app that combines the power of Lichess and Anki._
| | Chessli |
| --- | --- |
| Project | [](https://github.com/pwenker/chessli)  
| Activity & Issue Tracking |  [](https://github.com/pwenker/chessli/issues?q=is%3Aopen+is%3Aissue) [](https://github.com/pwenker/chessli/issues?q=is%3Aissue+is%3Aclosed) |
| PyPI | [](https://pypi.org/project/chessli/)  [](https://pepy.tech/project/chessli)|
| Build & Health |   |
| Docs | [](https://pwenker.com/chessli) [](https://pwenker.com/chessli/tutorial/how_to_set_up_chessli) |
| News & Updates | [](https://twitter.com/PascalWenker) [](https://github.com/pwenker)|
## Demos
### CLI Demo (watch whole video on [Youtube](https://www.youtube.com/embed/XbD71Kq7cx4))
### Anki Cards Demo (watch whole video on [Youtube](https://www.youtube.com/watch?v=Diew--CWlsI))
## Documentation
Check out the [documentation](https://pwenker.com/chessli):
| | Tutorial |
| --- | --- |
Setup chessli | [How to set chessli up](https://pwenker.com/chessli/tutorial/how_to_set_up_chessli)
Games & Mistakes | [How to learn from your games](https://pwenker.com/chessli/tutorial/how_to_learn_from_your_games)
Openings | [How to build an opening repertoire](https://pwenker.com/chessli/tutorial/how_to_create_an_opening_repertoire)
Tactics | [How to get better at tactics](https://pwenker.com/chessli/tutorial/how_to_get_better_at_tactics)
Anki Cards | [How to use chessli's anki cards](https://pwenker.com/chessli/tutorial/how_to_use_chesslis_anki_cards)
## Features
- **Automatically fetch your games** and played tactics puzzles from [`lichess`](https://www.lichess.org) via the [`berserk`](https://github.com/rhgrant10/berserk) python client for the Lichess API.!
- **Find your mistakes** by parsing your games and analysing them with [`python-chess`](https://github.com/niklasf/python-chess).
- **Build a simple opening repertoire and list your known openings**
- **Spaced repetition & Retrieval Practice**: Automatically (via [`apy`](https://github.com/lervag/apy)) or manually (via csv export) add your game mistakes, your openings and your tackled lichess puzzles into [`Anki`](https://apps.ankiweb.net/)
- **Stats and visualizations**: Seamlessly show `lichess leaderboards` or plot your `rating history`.
## Getting Started
### Installation
1. Install `pip`. See [here](https://pip.pypa.io/en/stable/installing/) for help.
2. Install chessli with `pip`:
```console
pip install chessli
```
That's it!
## Basic Usage
To get help about `chessli`s commands, open your console and type:
```console
chessli --help
```
The same works for subcommands, e.g., :
```console
chessli games --help
```
You can find an overview of all availabe cli-commands [here](https://pwenker.com/chessli/cli/) in
the docs.
### Tutorial
Now as you are familiar with the basics, you might want to walk through the tutorial to get the most
out of `chessli`!
Start with [setting up chessli](https://pwenker.com/tutorial/how_to_set_up_chesslid).
## Acknowledgments
| | Acknowledgements |
| --- | --- |
| [`Lichess`](https://lichess.org) | A free, no-ads, open source chess server that let's everyone play chess! Think about whether to [become a patron](https://lichess.org/patron)! :) |
| [`Anki`](https://apps.ankiweb.net/) | A free and open-source flashcard program using spaced-repetition, a technique from cognitive science for fast and long-lasting memorization. I couldn't imagine learning without it anymore. |
| [`Anki Card Templates`](https://ankiweb.net/shared/info/1082754005) | The interactive chess functionality on Chessli's anki cards is based from [these fantastic cards](https://ankiweb.net/shared/info/1082754005).|
| [`python-chess`](https://github.com/niklasf/python-chess) | Most of the heavy lifting, e.g. parsing games, finding mistakes, extracting openings, etc. is done with `python-chess`. |
| [`berserk`](https://github.com/rhgrant10/berserk) | The communication between `lichess` and `chessli` is performed via `berserk` |
| [`typer`](https://github.com/tiangolo/typer) | The `chessli` `cli` is built with the great `typer` |
| [`rich`](https://github.com/willmcgugan/rich) | The rich colors and fancy tables are made possible by `rich` |
| [`apy`](https://github.com/lervag/apy/) | Importing cards directly into anki without csv-export can be done via `apy` |