owenrees f37242ed29 Add local tablebase path config, fetch and check tasks (#31)
Read the local Syzygy directory from TABLEBASE_PATH so a dev machine and a VPS can point at their own copies. Add mix tablebase.fetch (downloads the 3/4/5 WDL+DTZ set, resumable) and mix tablebase.check (verifies it loads), plus a boot log reporting whether local tablebases are ready and the largest piece count.

Covers the codeable part of #31; installing on the VPS and setting TABLEBASE_PATH there remains a manual step.
2026-11-03 14:26:30 +01:00
2026-06-20 19:08:18 +02:00
2026-11-03 13:41:54 +01:00
2026-06-20 19:08:18 +02:00
2026-11-03 13:41:54 +01:00
2026-11-03 13:41:54 +01:00

Chesstrainer

To start your Phoenix server:

  • Run docker compose up -d to run the development database
  • Run mix setup to install and setup dependencies
  • Start Phoenix endpoint with mix phx.server or inside IEx with iex -S mix phx.server

Now you can visit localhost:4000 from your browser.

Ready to run in production? Please check our deployment guides.

Local tablebases (optional)

Positions with five or fewer pieces are answered locally from Syzygy tablebases when TABLEBASE_PATH points at a directory of .rtbw/.rtbz files. When it is unset the trainer falls back to the Lichess API.

TABLEBASE_PATH lets each environment point at its own copy — it differs on a dev machine and a VPS:

# Fetch the complete 3/4/5-piece WDL+DTZ set (~939 MB) once per host.
mix tablebase.fetch --path /path/to/syzygy/3-4-5
mix tablebase.check --path /path/to/syzygy/3-4-5

# Dev
TABLEBASE_PATH=/path/to/syzygy/3-4-5 mix phx.server

# Production
TABLEBASE_PATH=/data/syzygy/3-4-5 bin/chesstrainer start

On boot the app logs whether the local tablebases loaded and the largest piece count they cover, so a wrong path shows up immediately.

Learn more

S
Description
No description provided
Readme
1.7 MiB
Languages
Elixir 83.4%
HTML 7%
Shell 3.6%
CSS 3%
JavaScript 2%
Other 0.9%