Checkout the deployed GUI or the research paper
This repository contains several main sections. The game logic is contained to the blokus module. MCTS and game simulation logic is in self-play. The model directory contains the model architectures along with scripts for testing and training the models. There is also a GUI, though it is a work in progress.
All of the configuration for training is done in the model/training.py config class. For more details on hyperparamter selection and
various experiments, check out report.pdf
To build a local version of the Rust libraries, run
maturin develop
Alternatively, you can install a published version from PyPI with
pip install blokus-engine
To open the GUI in the browser run the model server and the proxy server then run:
cd gui
trunk serve --open
To train locally, run:
python model/training.py --test --workers 1 --dim 20 --load <model_path> --save <new_path>
Without the test flag, metrics are logged and plotted useing weights and biases.
To test the model, you can run the following command:
python model/testing.py [num_games] [model_path] [benchmark_model_path]