Skip to content

bcattaneo/whitecape

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Logo

Whitecape

A proof-of-concept of a chess helper

Disclaimer

DO NOT USE in ranked games or you'll get banned, actually don't even use it in casual games. This script is not intended for cheating your way up to a high ELO, but rather to help you learn good chess.

Here is a example account I made, which played five perfect matches (except for one where I blundered a pawn) against some high rated opponents. The account is now banned.

About

For users

A Greasemonkey script that will give you the best next move (provided by Stockfish) in a lichess game.

Logo

For developers

Source code of the script and a flask API that runs stockfish.

Installation

For users

  1. Install Greasemonkey (firefox) or Tampermonkey (chrome or others).
  2. Navigate to https://www.cattaneo.uy/whitecape/whitecape.user.js. You'll get prompted with an installation form.
  3. Go to Lichess and try it out.

For developers

First clone this repository.

Script

  1. Install Greasemonkey (firefox) or Tampermonkey (chrome or others).
  2. Add scripts/whitecape.user.js to your plugin. Feel free to modify anything, especially the API URL if you intend to change it.

API

  1. Install Stockfish. You'll need a full path to its main program.
  2. Modify api/.env.tmp, changing stockfish-path to yours. On windows could be c:\stockfish\stockfish.exe, on *unix /usr/bin/stockfish
  3. Rename .env.tmp to .env
  4. If you want to use docker, just skip those steps and build the provided dockerfile.
  5. Install requirements with python -r api/requirements.txt
  6. Run with python api/main.py

License

GPL v3