Install Guild AI

  1. Requirements
  2. Install Guild AI
    1. Using pip
    2. Using conda
    3. With Docker
    4. From source code
  3. Install TensorFlow
  4. Install optional libraries
    1. CUDA and cuDNN
    2. NVIDIA System Management Interface
  5. Verify your installation
  6. Next steps

Requirements

Guild AI has the following requirements:

  • macOS, Linux, or Windows
  • Docker (required for Windows only)
  • Python 2.7 or Python 3
  • pip or conda

Install Guild AI

Using pip

To install Guild AI, run the following command:

pip install --user guildai

If you want to install Guild at the system level, omit the ‑‑user option and run the command as an administrator:

sudo guild install guildai

If you want the latest pre-release version of Guild AI, use the ‑‑pre option:

pip install --pre --user guildai

Using conda

If you’re using conda, activate your environment:

conda activate ENV-NAME

Next, install Guild using pip:

pip install guildai

With Docker

Note

Installing Guild with Docker requires that you have Docker installed. Refer to About Docker CE for instructions for your platform.

Note

Docker is the only way to run Guild on Windows at this time.

Guild AI provides a Docker image that you can install by running:

docker pull guildai/guildai

Start an interactive TTY session using the image by running:

docker run -it guildai

From within the container, you can execute Guild commands.

From source code

Note

This step is an alternative to installing Guild AI with pip described above. Install Guild AI from source code if you want a specific version from GitHub (e.g. an early release or development branch) or if you want to contribute to the project.

Additional required tools for installing from source code:

  • git
  • npm v5.8.0 or later
  • Python development library and headers for your system

To install Guild from source, clone the repository by running:

git clone https://github.com/guildai/guildai.git

Change to the guild directory and install the required pip packages:

cd guildai
pip install -r requirements.txt

Build Guild by running:

python setup.py build

Verify Guild by running:

guild/scripts/guild check

If see the message NOT INSTALLED (No module named 'tensorflow') that’s okay - you’ll install TensorFlow in the steps below. If you see other errors, please open an issue on GitHub and we’ll help!

You can run the GUILD_SOURCE_DIR/guild/scripts/guild executable directly (where GUILD_SOURCE_DIR is the location of your cloned Guild AI source repository) or modify your environment to make guild available on your PATH using one of these methods:

  • Add GUILD_SOURCE_DIR/guild/scripts directory to your PATH environment variable, OR
  • Create a symlink to GUILD_SOURCE_DIR/guild/scripts/guild that is available on your PATH

Install TensorFlow

Guild requires TensorFlow but does not install it for you. 1 You can use pip to install TensorFlow by running:

pip install tensorflow

If your system has a GPU, install the GPU enabled package by running:

pip install tensorflow-gpu

For alternative installation methods, refer to Installing TensorFlow.

Install optional libraries

If you system has a GPU or other accelerator supported by TensorFlow, you will need to install and configure support for your hardware.

CUDA and cuDNN

If you have an NVIDIA GPU and and want to use the GPU enabled TensorFlow package, you must install the NVIDIA CUDA and cuDNN libraries for your system. Refer to the links below for help installing the libraries.

NVIDIA System Management Interface

Guild uses NVIDIA System Management Interface (nvidia‑smi) on GPU accelerated systems to collect GPU metrics. This tool is optional and Guild will run without it. However, to collect GPU stats on systems with one or more GPUs, ensure that nvidia‑smi is installed.

Note

NVIDIA System Management Interface is typically installed with NVIDIA GPU drivers. Refer to NVIDIA System Management Interface for more information.

Verify your installation

Verify that Guild is installed properly by running the check command:

guild check

If there are problems with your installation, Guild will display the details and exit with an error. Refer to Troubleshooting for assistance.

Next steps

Congratulations, you’ve installed Guild AI! We’ve outlined some next steps for you below.

Get Started

Start using Guild to train a simple model.

Get Started

Browse the docs

If you're interested in a complete picture of Guild AI, browse the comprehensives documentation.

Browse the docs

  1. TensorFlow is a rapidly evolving software library and is provided as both CPU and GPU supported packages. Guild leaves the specific package and version of TensorFlow up to the user.