Release 0.7.1

This version was released on Dec 5, 2020.


Command completion

Install command completion for the current shell by running guild completion. Supported shells: bash, zsh, and fish.


Tags are a formal construct in 0.7.1. When you generate a run, you can assign one or more tags using the -t, --tag option. Tags can be used when filtering runs using the -ft, --tag option.


Generate a run with the blue tag:

guild run --tag blue

Tags are included in default run labels.

Filter runs using the blue tag (multiple tags can be specified to expand the results):

guild runs --tag blue

Tags can be added and removed using the tag command.

Add a blue tag to the latest run:

guild tag -a blue

Remove the blue tag:

guild tag -d blue


Guild 0.7.1 provides support for adding comments to runs. Refer to comment command help for details.


Add a comment to a new run:

guild run --comment "Testing different kernels"

View run comments from runs list:

guild runs list --comments

View run comments from runs info:

guild runs info --comments

Filter runs containing comment text:

guild runs --comment kernels

Add a comment to an existing run:

guild comment [RUN]

Delete a comment:

guild comment [RUN] --delete INDEX

Set breakpoints for a run

Guild 0.7.1 supports breakpoints for Python based operations using three different methods:

  • Break at a specific location — either at a module line number or at a function — with --break
  • Break on error with --break-on-error

Use --break 1 to break at the start of the main Python module.

Option to show all scalar summaries

The --all-scalars option to guild runs info now shows all scalar summaries, not just the last value.

guild runs info --all-scalars
id: 71a309bdb7d7479089d9b96daaf04e7c
operation: train
    avg: 0.955700 (step 3)
    first: 0.930400 (step 1)
    last: 0.971800 (step 2)
    max: 0.971800 (step 1)
    min: 0.930400 (step 1)
    total: 2.867100 (step 3)
    avg: 0.145833 (step 3)
    first: 0.236100 (step 1)
    last: 0.088800 (step 2)
    max: 0.236100 (step 2)
    min: 0.088800 (step 2)
    total: 0.437500 (step 3)

Export all scalar values for all steps #209

Guild supports exporting scalars for selected runs using a new --export-scalars option for guild tensorboard.

guild tensorboard --export-scalars scalars.csv

Use the special path - (dash) to print to standard output.

Support for doctest style project tests

0.7.1 introduces support for running a doctest file using guild check. This is used to verify issue resolution in

Python 3.8 support on Windows

Pre-compiled binaries are available for Python 3.8 on Windows.

New --system-site-packages option for init command

Use --system-site-packages option with guild init to make system site Python packages available within the environment. This can be used to save disk space and reduce the time to create the virtual environment.

Support latest versions of scikit-learn

0.7.0 was limited to support versions of scikit-learn prior to 0.23.

Support for list value args #226

Flags support arg-split attribute that lets you split a string flag argument into a list.


Guild view not able to handle infinity and nan scalar values #241

Unwanted type casting of FLAG values #210

NaN scalar logged in tensorboard would crash guild runs info #211

Queues compete with batch operations to start staged runs #215

Guild stops on trial error when using Skopt based optimizers #225

Time column in guild.ipy stored as Pandas timedelta #243

Breaking Change Code that relies on time being a string will break with version 0.7.1. To convert values to string use Python’s built-in str function. See pandas.Timedelta for details on the new column type.

Fixes to sync

A number of issues with the sync command are resolved.