gomoku

Local Development

When developing Gomoku locally, Docker is essential. Requires Docker and Docker Compose v2+.

1. Clone GitHub repo

      $ git clone [email protected]:sungyongcho/gomoku.git
$ cd gomoku
bash

alphazero/models/champion.pt is versioned in this repository, so cloning includes the latest local AlphaZero checkpoint by default.

2. Apply alias.sh

      $ source alias.sh
bash

This provides convenience aliases: dev-up (full stack), dev-up-front (frontend only), dev-down (stop all), dev-up-debug / dev-up-valgrind (debugging), and cluster/deployment helpers.

3. Create .env in project root

      LOCAL_FRONT=3000
LOCAL_FRONT_NUXT_CONTENT_WS=4000
LOCAL_MINIMAX=8005
LOCAL_MINIMAX_GDB=8006
LOCAL_ALPHAZERO=8080

FRONT_WHERE=local
# These DEPLOY_* vars are also used by the local AlphaZero Docker container.
DEPLOY_ALPHAZERO_CONFIG=configs/deploy.yaml # edit num_searches, etc. for deployment
DEPLOY_ALPHAZERO_DEVICE=cpu
.env

For the complete variable list and sectioned defaults, check .env.example.

4. Launch Application

Full stack (frontend + minimax + AlphaZero):

      $ dev-up
bash

Frontend only (no backend dependencies):

      $ dev-up-front
bash

Frontend + minimax only (no PyTorch/model dependencies):

      $ docker compose -f docker-compose.yml up front minimax
bash
Prev Next