MAINTAINER OIVAS7572 AND MOVINDUTB
- A bridge between Lichess API and bots.
- This bot is made with Python and it is running using Docker container and is concentrated on heroku.
- Import or Fork this repository to your Github.
- Open the
Settings
tab on heroku and insert your API access token withbot:play
scopes enabled in theConfig vars
field in the formatLICHESS_BOT_TOKEN:API-ACCESS-TOKEN
, where you replaceAPI-ACCESS-TOKEN
with your API Access token. - Install Heroku CLI and create a new app in Heroku.
Do note that in certain operating systems Heroku CLI doesn't get added to path automatically. If that's the case you'll have to add heroku to your path manually. - Run this command in cmd or powershell
heroku stack:set container -a appname
, whereappname
is replaced with your Heroku app's name. - Deploy your repository to heroku
- After deploying wait for about 5 minutes till the build finishes and then in the
Resources
tab in heroku turnworker
dynos. If you do not see any option to enable any dynos, then you'll have to wait for about 5 minutes and then refresh your page on heroku.
You're now connected to lichess and awaiting challenges! Your bot is up and ready!
Engine:
- Stockfish 15 with the default NNUE.
Opening Books:
Keep you Forks or Imports Up-to-Date & Check the other Branches in this Repository
If you would like to run bot locally on PC, read the lichess-bot manual.
Changing the engine to an engine of your preference is simple. Just follow the following steps:
- Firstly, you have to remove the engine used. To do this you need delete the file named
stockfish15
in theengines/
folder. - Then you need to download the binary of the chess engine you want to used and into your GitHub repository, Go to the
engines/
folder, Click onAdd files
and then clickUpload files
and upload the binary of the chess engine you have downloaded.
Note: Make sure you download a linux binary that is supported by heroku (by default Stockfish is used, and the default engine name isstockfish15
). - Then change the name of engine in 6th line of config.yml and 14th line of Dockerfile to your binary file's name.
Credits to ShailChoksi's lichess-bot.
This code is primarily taken from lichess-bot by ShailChoksi and is hence run under the AGPLv3 License (or later at your option). Check out the LICENSE file for full text.