Helping Hand

Lichess chess bot with Stockfish integration

Features

• Auto-play: Bot automatically plays moves on Lichess
• Time control presets: Auto-detects game speed and adjusts engine settings (bullet/blitz/rapid/classical)
• Humanization: Randomized delays to simulate human-like play
• Live board display: Shows current position with move suggestions
• Statistics tracking: Session and all-time win/loss/draw stats

Setup

1. Download the latest release
2. Extract and add your Lichess cookies to deps/lichess.org.cookies.json
3. Run helping-hand.exe

Getting cookies: Use Cookie JSON Exporter on lichess.org while logged in.

Manual setup (from source)

git clone https://github.com/kWAYTV/helping-hand.git
cd helping-hand
pip install -r requirements.txt

Required in deps/ folder:

• Stockfish → deps/stockfish/stockfish.exe
• GeckoDriver → deps/geckodriver/geckodriver.exe
• xPath Finder → deps/xpath_finder.xpi
• Chess Merida Font → deps/merifont.ttf

Config

Copy config.example.ini to config.ini and adjust:

Section	Key	Description
engine	path	Path to Stockfish executable
engine	depth	Search depth (1-30). Higher = stronger but slower
engine	skill-level	Stockfish skill (0-20). Lower = weaker play
general	arrow	Show move suggestion arrow on board
general	auto-preset	Auto-adjust settings based on time control
humanization	min-delay	Minimum delay before moves (seconds)
humanization	max-delay	Maximum delay before moves (seconds)
browser	geckodriver-path	Path to GeckoDriver executable
browser	firefox-binary-path	Path to Firefox

Disclaimer

POC for educational purposes. Use at your own risk.