Lichess Chess Bot

Professional automated chess assistant for Lichess.org featuring Stockfish engine integration and advanced humanization algorithms

Features

• Stockfish Integration: Configurable engine depth and skill levels
• Modern GUI: Real-time board visualization with move suggestions
• Smart Humanization: Randomized timing patterns to simulate human play
• Dual Modes: Fully automated or suggestion-only operation
• Cross-Platform: Windows and Linux support

Installation

Option 1: Pre-built Release (Recommended)

1. Download from GitHub Releases
2. Extract and configure config.ini (see config.example.ini)
3. Export your Lichess cookies (see Authentication)
4. Run the executable

Option 2: From Source

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

Dependencies (place in deps/ folder):

• Stockfish Engine
• GeckoDriver
• xPath Finder Extension (.xpi file)

Authentication

This bot uses cookie-based authentication. Export your Lichess cookies using one of these browser extensions:

• Chrome Extension
• Firefox Extension

Steps:

1. Log in to lichess.org in your browser
2. Use the extension to export cookies while on the Lichess site
3. The extension will save a file named lichess.org.cookies.json
4. Place this file in the deps/ folder

Configuration

Essential config.ini settings:

[engine]
depth = 5          # Analysis depth (1-20)
skill-level = 14   # Engine strength (0-20)

[general]
auto-play = true   # Auto-execute moves
move-key = end     # Manual trigger key
log-level = INFO   # Logging verbosity

Usage

AutoPlay Mode

Fully automated gameplay with built-in humanization delays (0.3-3.0s randomization).

Suggestion Mode

Displays engine recommendations requiring manual confirmation via hotkey or GUI.

GUI Features

• Live chess board with position tracking
• Engine move suggestions with visual arrows
• Real-time game information and statistics
• Color-coded activity log with auto-scroll
• Manual control panel

Disclaimer

This is a proof of concept (POC) for educational and research purposes only.

The developers assume no responsibility or liability for any consequences arising from the use of this software. Users are solely responsible for:

• Compliance with Lichess Terms of Service
• Any account actions or penalties
• Legal implications in their jurisdiction

Use at your own risk.