lichess-bot-devs/lichess-bot

lichess-bot-devs/lichess-bot has 1,107 GitHub stars and 593 forks. GitHot measured +1 in 7 days. Last checked 2026-11-11 00:14 UTC. Last push 2026-11-02.

How these counts are measured

A bridge between Lichess bots and chess engines

1,107 stars 593 forks

What you can do

Every variant and time control
UCI, XBoard, and Homemade engines
Matchmaking (challenging other bots)
Offering Draws and Resigning

Measured star growth

in 24h: Update delayed
in 7 days: +1
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

lichess-bot

A bridge between lichess.org and bots.
Explore lichess-bot docs »

Overview

lichess-bot is a free bridge between the Lichess Bot API and chess engines.

With lichess-bot, you can create and operate a bot on lichess. Your bot will be able to play against humans and bots alike, and you will be able to view these games live on lichess.

See also the lichess-bot documentation for further usage help.

Features

Supports:

Every variant and time control
UCI, XBoard, and Homemade engines
Matchmaking (challenging other bots)
Offering Draws and Resigning
Participating in tournaments
Accepting move takeback requests from opponents
Saving games as PGN
Local & Online Opening Books
Local & Online Endgame Tablebases

Can run on:

Python 3.11 and later
Windows, Linux and MacOS
Docker

Steps

Advanced options

Acknowledgements

Thanks to the Lichess team, especially T. Alexander Lystad and Thibault Duplessis for working with the LeelaChessZero team to get this API up. Thanks to Niklas Fiekas and his python-chess code which allows engine communication seamlessly.

License

lichess-bot is licensed under the AGPLv3 (or any later version at your option). Check out the LICENSE file for the full text.

Citation

If this software has been used for research purposes, please cite it using the "Cite this repository" menu on the right sidebar. For more information, check the CITATION file.