UnrealGo

UnrealGo is a experimental implementation of alphagoZero in C++. It's developed with MCTS and deep reinforcement learning. It can be trained from scratch.

Dependencies

Boost - 1.64+
http://www.boost.org/

# build boost from source
$ ./bootstrap.sh
$ ./b2
# set LIB_INSTALL_DIR
$ cp -rf stage/lib/ ${LIB_INSTALL_DIR}
# edit and add lib directory to file /etc/ld.so.conf
$ sudo ldconfig

ZMQ - 4.2.2

$ git clone https://github.com/zeromq/libzmq.git
$ sudo apt-get install autogen autoconf libtool
$ ./autogen.sh
$ ./configure
$ ./make
$ ./make install

build tensorflow cmake interface

tensorflow cmake interface
Assume $PROJ_WORKSPACE is your project home directory

# clone tensorflow
$ cd $PROJ_WORKSPACE
$ git clone https://github.com/tensorflow/tensorflow.git
# git checkout to desired version(e.g. 1.6) if you like

# build interface
$ git clone https://github.com/unrealgo/tensorflow_cmake_interface.git
$ cd tensorflow_cmake_interface
$ mkdir build
$ cd build
$ cmake -DTENSORFLOW_SHARED=ON -DTENSORFLOW_SOURCE_DIR="$PROJ_WORKSPACE/tensorflow" ..
$ make
$ make install

After finishing build, the interface is installed at TensorflowCC="$PROJ_WORKSPACE/tensorflow_cmake_interface/build/lib/cmake/TensorflowCC"

Build UnrealGo

Build UnrealGo with tensorflow cmake interface:

$ git clone https://github.com/unrealgo/unrealgo.git
$ mkdir build
$ cd build
$ cmake -DTensorflowCC="$PROJ_WORKSPACE/tensorflow_cmake_interface/build/lib/cmake/TensorflowCC" ../
$ make -j4

Run UnrealGo

The binary is installed at $PROJ_WORKSPACE/unrealgo/bin. To run unrealgo, the network checkpoint(weights) is needed. A bootstrap checkpoint of 20 residual block is provided, decompress and copy to bin/

# first     copy config/dlcfg-19 to bin/
$ cd $PROJ_WORKSPACE/
$ cp config/dlcfg-19 bin/

$ tar xvf bootstrap.tar.gz
$ mv bootstrap-ckpt.* bin/

# start unrealgo, type selfplay to start self play.
$ ./unrealgo
 selfplay

GUI

Sabaki

$ git clone https://github.com/SabakiHQ/Sabaki.git
$ cd Sabaki/dist/linux-unpacked
$ ./sabaki

TODO

Network compression

License

UnrealGo is licensed under GPLv3 or later.

redmouth/unrealgo