Go Chess API

Chess

Go backend server providing a RESTful API for chess gameplay. Integrates Stockfish engine for move validation and AI opponents.

Features

RESTful API for chess operations
Stockfish engine integration for validation and AI
Human vs human, human vs computer, computer vs computer modes
Custom FEN position support
Asynchronous AI move calculation
Configurable AI strength and thinking time

Requirements

Go 1.24+
Stockfish chess engine (stockfish in PATH)

Installation

# Arch Linux
yay -S stockfish

# FreeBSD
pkg install stockfish

Quick Start

git clone https://git.lixen.com/lixen/chess
cd chess
go build ./cmd/chessd

# Standard mode (1 request/second/IP)
./chessd

# Development mode (10 requests/second/IP)
./chessd -dev

# Run tests (requires dev mode)
./test/test-api.sh

Server listens on http://localhost:8080. See API Reference for endpoints.

Documentation

API Reference - Endpoint specifications
Architecture - System design
Development - Build and test instructions
Stockfish Integration - Engine communication

License

BSD 3-Clause

1.6 KiB Raw Blame History