asyncLio-bot is a bridge between UCI chess engines and Lichess using an async/await pattern. It handles multiple concurrent games and includes a matchmaker.
To use asyncLio-bot (requires Python 3.10 or later):
- Clone the repo as
git clone git@github.com:Heiaha/asyncLio-bot.git
. - Copy
config.default.yml
toconfig.yml
and customize to your liking. - Install the required packages in your environment (preferably using venv or conda) like
python -m pip install -r requirements.txt
.
- Create an account for a BOT on Lichess.
- Create a new OAuth token with the "Play games with the bot API" permission.
- Use this token in your config.yml file.
To use asyncLio-bot your account must be upgraded to a BOT, which requires it to not have played any games.
Make sure this is something you desire, as it is irreversible.
For a bit more information, see the relevant announcement.
To upgrade your account, make sure your OAuth key is in config.yml
and run python main.py --upgrade
Significant inspiration for this repository is drawn from lichess-bot and BotLi.