Install Guild AI


Guild AI has the following requirements:

  • macOS, Linux, Windows (Windows requires Python 3)
  • Python 2.7, Python 3
  • pip or conda

For a complete list of supported platforms, see System Requirements.

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 pip install guildai

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

pip install --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.

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

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

cd guildai
pip install -r requirements.txt

Build Guild by running:

python 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, let us know 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

Command Completion

Guild AI supports command completion on bash, zsh, and fish shells. When configured correctly, this feature lets you press Tab when tying a command to show available completion options.

To install command completion for your shell, run:

guild completion --install

This command modifies your shell’s init script to support Guild’s command completion. Before Guild makes any changes, it creates a copy of your init script named <file>.guild-backup.N where N is an incrementing number.

Open a new terminal session to verify that command completion is supported. After opening a new terminal, type guild followed by a space and press Tab. If running bash, press Tab a second time. If completion is configured correctly you will see the list of available Guild commands.

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 guild check:

guild check

If there are problems with your installation, Guild shows the details and exits with an error.

Next Steps

Congratulations, you’ve installed Guild AI!

To learn more about Guild, follow the steps in Get Started with Guild AI.

For more help, see Guild AI Documentation.

1 Like