sethtroisi / cloudygo

Website for MiniGo, Leela-Zero and other Go data
http://cloudygo.com
Apache License 2.0
20 stars 10 forks source link
game-of-go go minigo

CloudyGo

Frontend for displaying MiniGo, Leela-Zero, and other Go data.

This is not an official Google product.

Getting Started

Visit CloudyGo.com to see a live version.

Prerequisites

The site requires several python libraries, this may not be a complete list

pip3 install choix flask numpy tqdm sqlite3 requests

sgftopng is required to render some images, but isn't required to run.

For local development I suggest using devel_instance.7z to bootstrap.

devel_instance.7z contains enough of MiniGo v3-9x9 and v7-19x19 data to test the UI.

7z x devel_instance.7z
mv -n devel_instance instance
./oneoff/repopulate_db.sh
./updater.py models True v3-9x9 v5-19x19 v7-19x19 leela-zero-v1
./updater.py games v3-9x9 v5-19x19 v7-19x19 leela-zero-v1
./updater.py eval_games v3-9x9 v5-19x19 v7-19x19 leela-zero-v1
./updater.py position_evals v3-9x9 v5-19x19 v7-19x19 leela-zero-v1
FLASK_DEBUG=1 FLASK_APP="web/serve.py" flask run --host 0.0.0.0 --port 5000
# follow instructions in SETUP so SGFS can be rendered with WGo.js

Coding style

Style guide is a mix of Google Python + PEP8, Some older code may not be perfectly compliant.

Deployment

CloudyGo.com is run by Seth Troisi, local deployment is normally tested with

FLASK_DEBUG=1 FLASK_APP="web/serve.py" flask run --host 0.0.0.0 --port 6000

Full Site Setup

instance/             # Created with oneoff/repopulate_db.sh from schema.sql
├── cloudygo.db       # Created with oneoff/repopulate_db.sh from schema.sql
├── data/             # directory (or link to directory) of MiniGo training data
│   ├── v7-19x19/     # Training Run #1
│   │   ├── models/   # See minigo-pub Google Cloud Storage Bucket
│   │   ├── sgf/      # See minigo-pub Google Cloud Storage Bucket
│   └── ...           # Other Training Runs
├── eval/v7-19x19/    # Figure 3 details produced by minigo/oneoffs
├── policy/v7-19x19/  # Policy heatmaps produced by minigo/oneoffs
├── pv/v7-19x19/      # Principle variations produced by minigo/oneoffs
├── openings/         # PNGs of openings (deprecated)
├── debug/            # various logs served by easter egg secrets page

Contributing

Please read CONTRIBUTING for details on our code of conduct, and the process for submitting pull requests.

License

This project is licensed under the Apache 2 License - see LICENSE file for details

Authors

See also the list of AUTHORS who participated in this project.

Acknowledgments

Links