Counting 2,129 Big Data & Machine Learning Frameworks, Toolsets, and Examples...
Suggestion? Feedback? Tweet @stkim1

Project Page
Last Commit
Dec. 11, 2017
Sep. 9, 2016

Guild Python

Project status: pre-alpha

This is the active Guild source repository.

Guild has been rewritten in Python and has undergone substantial changes since its original release.

Documentation on will be forthcoming. For time being, please submit issues to the project GitHub issue tracker.

Installing Guild AI

Preliminary releases of Linux wheels are available on PyPI. To install the latest version, run:

$ pip install guildai --upgrade

If your platform isn't support, you can compile Guild AI from source (see steps below).

Compiling Guild AI from source

Guild Python requires Bazel 0.5.4 or higher to build. See Installing Bazel for help with you system.

Clone Guild Python from GitHub:

$ git clone

Build Guild Python using the bazel command:

$ cd guild-python
$ bazel build guild

You may alternatively simply run make.

The initial Guild Python build will take some time as Bazel will download several dependencies, including TensorBoard. Subsequent builds will run faster.

If Guild Python builds successfully, run the check command with tests:

$ bazel-bin/guild/guild check --tests

You may alternatively run make check.

Please report any failed tests to the project GitHub issue tracker.

To run guild without typing its full path, create an alias:

alias guild=$GUILD_REPO/bazel-bin/guild/guild

where $GUILD_REPO is a reference to your local Guild git repository.

Using Guild AI

Clone the Guild Examples:

$ git clone

Change to the mnist2 example and train the default model:

$ cd guild-examples/mnist2
$ guild train

You will be asked to confirm that you want to train the mnist-intro model. Press enter to continue.

Guild will train the MNIST intro model, which is a simple softmax regression. It should only take a view seconds to train.

In a second terminal, change to the mnist2 example directory and start Guild View:

$ cd guild-examples/mnist2
$ guild view

This will open TensorBoard where you can view the runs for the mnist2 project.

Getting help

Guild documentation is under development and not yet available. Use the command line help to familiarize yourself with Guild's features.

guild --help List available Guild commands
guild COMMAND --help Show help for COMMAND

Latest Releases
Guild AI v0.1.1
 Jun. 6 2017
Guild AI v0.1.0
 May. 19 2017
Guild AI v0.1.0-pre2
 May. 5 2017
Guild AI v0.1.0-pre1
 May. 3 2017
Guild AI v0.1.0-alpha.2
 Jan. 19 2017