Keras Reference




WandbCallback automatically integrates keras with wandb.

Examples:, y_train, validation_data=(X_test, y_test),

WandbCallback will automatically log history data from any metrics collected by keras: loss and anything passed into keras_model.compile()

WandbCallback will set summary metrics for the run associated with the "best" training step, where "best" is defined by the monitor and mode attribues. This defaults to the epoch with the minimum val_loss. WandbCallback will by default save the model associated with the best epoch..

WandbCallback can optionally log gradient and parameter histograms.

WandbCallback can optionally save training and validation data for wandb to visualize.


  • monitor str - name of metric to monitor. Defaults to val_loss.

  • mode str - one of {"auto", "min", "max"}. "min" - save model when monitor is minimized "max" - save model when monitor is maximized "auto" - try to guess when to save the model (default). save_model: True - save a model when monitor beats all previous epochs False - don't save models

  • save_weights_only boolean - if True, then only the model's weights will be saved (model.save_weights(filepath)), else the full model is saved (

  • log_weights - (boolean) if True save histograms of the model's layer's weights.

  • log_gradients - (boolean) if True log histograms of the training gradients. The model must define a total_loss.

  • training_data - (tuple) Same format (X,y) as passed to This is needed for calculating gradients - this is mandatory if log_gradients is True.

  • validation_data - (tuple) Same format (X,y) as passed to A set of data for wandb to visualize. If this is set, every epoch, wandb will make a small number of predictions and save the results for later visualization.

  • generator generator - a generator that returns validation data for wandb to visualize. This generator should return tuples (X,y). Either validate_data or generator should be set for wandb to visualize specific data examples.

  • validation_steps int - if validation_data is a generator, how many steps to run the generator for the full validation set.

  • labels list - If you are visualizing your data with wandb this list of labels will convert numeric output to understandable string if you are building a multiclass classifier. If you are making a binary classifier you can pass in a list of two labels ["label for false", "label for true"]. If validate_data and generator are both false, this won't do anything.

  • predictions int - the number of predictions to make for visualization each epoch, max is 100.

  • input_type string - type of the model input to help visualization. can be one of: ("image", "images", "segmentation_mask").

  • output_type string - type of the model output to help visualziation. can be one of: ("image", "images", "segmentation_mask").

  • log_evaluation boolean - if True save a dataframe containing the full validation results at the end of training.

  • class_colors [float, float, float] - if the input or output is a segmentation mask, an array containing an rgb tuple (range 0-1) for each class.

  • log_batch_frequency integer - if None, callback will log every epoch. If set to integer, callback will log training metrics every log_batch_frequency batches.

  • log_best_prefix string - if None, no extra summary metrics will be saved. If set to a string, the monitored metric and epoch will be prepended with this value and stored as summary metrics.