al3xkras / chess-com-bot-selenium

Chess.com bot (Docker-Selenium)

chess-com-bot

A Chess.com bot based on the Stockfish chess engine and the Selenium WebDriver.

• Engine's ELO rating, and other properties can be modified in the command line arguments.

• Supported on any platform that can run Docker/Docker-Selenium and on Windows.

Setup (docker-selenium):

1. Install Docker
2. Build container images: docker/docker_build.bat / docker/docker_build.sh. (once / to apply changes)
3. Run the docker-compose: docker_main.bat / docker_main.sh.
4. Wait until Selenium containers are accessible at http://localhost:7900/ (interface: NoVNC)
5. Optional properties that can be modified in docker/docker-compose.yml:
   • elo_rating - engine's ELO rating (default value: -1)
   • game_timer_ms - game timer in milliseconds (default value: 150000)
   • first_move_w - initial move when playing white pieces (default value: "e2e4")
   • enable_move_delay - enable delay between moves (default value: False)
   • next_game_auto - start the next game automatically (default value: True)
6. To exit the program, run cd docker && docker-compose stop, the containers can as well be stopped from the Docker Desktop UI.

Setup on Windows

1. Create a virtual environment:

   git clone --depth 1 https://github.com/al3xkras/chess-com-bot-selenium chess-com-bot 
   cd ./chess-com-bot

   pip install virtualenv & virtualenv venv

   "venv/Scripts/pip" install -r "requirements.txt"

2. Choose a compatible Stockfish release at (https://github.com/official-stockfish/Stockfish/releases). Unzip the contents into the ./stockfish/ directory of the project path. The executable should be renamed to "stockfish.exe"

3. Ensure that your Chrome version is supported by Selenium 4.17.0

4. Run

   "./venv/Scripts/python" main.py

5. Optional command line arguments:

   • --elo-rating - engine's ELO rating (default value: -1)
   • --game-timer-ms - game timer in milliseconds (default value: 150000)
   • --first-move-w - initial move when playing white pieces (default value: "e2e4")
   • --enable-move-delay - enable delay between moves (default value: False)
   • --next-game-auto - start the next game automatically (default value: True)
   • --help - list all available options

6. To exit the program, simply close the Chrome tab, or the command prompt window.

Tested OS & Chrome version:

• Windows 11 Version 23H2 (Build 22631.3007);
• Chrome 121.0.6167.161 (Official Build) (64-bit) (cohort: Stable)

Disclaimer

The software is provided as-is, without warranties of any kind. The author is not responsible for any adverse effects, including but not limited to account bans, resulting from the use of this bot.

Preview:

vid.mp4

chess-com-bot-selenium's Issues

Working in Ubuntu?

Make it work if it doesn't pls

Move slower

Great release.

How do you make it move the pieces "slower" to appear more legitmate

Errors

Errors, goes away after finding new match

Moving pieces

Sorry I couldn't find any other way to contact you
I'm making a chrome extension bot for chess.com also however im struggling to move the pieces i couldn't find the dom element that has the event listeners for clicking the piece in order to move it
I've tried all elements that have the mousedown, click (the board included)event listeners but couldn't make it
Can you explain me to me how did you move the pieces i'm not familiar with selenium
Thank you
[email protected]