YOLO Vision 2026:

Reference for ultralytics/utils/callbacks/base.py#

Improvements

This page is sourced from https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/base.py. Have an improvement or example to add? Open a Pull Request — thank you! 🙏


Summary

Function ultralytics.utils.callbacks.base.on_pretrain_routine_start#

def on_pretrain_routine_start(trainer)

Called at the beginning of the pre-training routine, before data loading and model setup.

GitHubultralytics/utils/callbacks/base.py
def on_pretrain_routine_start(trainer):
    """Called at the beginning of the pre-training routine, before data loading and model setup."""





Function ultralytics.utils.callbacks.base.on_pretrain_routine_end#

def on_pretrain_routine_end(trainer)

Called at the end of the pre-training routine, after data loading and model setup are complete.

GitHubultralytics/utils/callbacks/base.py
def on_pretrain_routine_end(trainer):
    """Called at the end of the pre-training routine, after data loading and model setup are complete."""





Function ultralytics.utils.callbacks.base.on_train_start#

def on_train_start(trainer)

Called when the training starts, before the first epoch begins.

GitHubultralytics/utils/callbacks/base.py
def on_train_start(trainer):
    """Called when the training starts, before the first epoch begins."""





Function ultralytics.utils.callbacks.base.on_train_epoch_start#

def on_train_epoch_start(trainer)

Called at the start of each training epoch, before batch iteration begins.

GitHubultralytics/utils/callbacks/base.py
def on_train_epoch_start(trainer):
    """Called at the start of each training epoch, before batch iteration begins."""





Function ultralytics.utils.callbacks.base.on_train_batch_start#

def on_train_batch_start(trainer)

Called at the start of each training batch, before the forward pass.

GitHubultralytics/utils/callbacks/base.py
def on_train_batch_start(trainer):
    """Called at the start of each training batch, before the forward pass."""





Function ultralytics.utils.callbacks.base.optimizer_step#

def optimizer_step(trainer)

Called during the optimizer step. Reserved for custom integrations; not called by default.

GitHubultralytics/utils/callbacks/base.py
def optimizer_step(trainer):
    """Called during the optimizer step. Reserved for custom integrations; not called by default."""





Function ultralytics.utils.callbacks.base.on_before_zero_grad#

def on_before_zero_grad(trainer)

Called before the gradients are set to zero. Reserved for custom integrations; not called by default.

GitHubultralytics/utils/callbacks/base.py
def on_before_zero_grad(trainer):
    """Called before the gradients are set to zero. Reserved for custom integrations; not called by default."""





Function ultralytics.utils.callbacks.base.on_train_batch_end#

def on_train_batch_end(trainer)

Called at the end of each training batch, after the backward pass. Optimizer step may be deferred by

accumulation.

GitHubultralytics/utils/callbacks/base.py
def on_train_batch_end(trainer):
    """Called at the end of each training batch, after the backward pass. Optimizer step may be deferred by
    accumulation.
    """





Function ultralytics.utils.callbacks.base.on_train_epoch_end#

def on_train_epoch_end(trainer)

Called at the end of each training epoch, after all batches but before validation.

GitHubultralytics/utils/callbacks/base.py
def on_train_epoch_end(trainer):
    """Called at the end of each training epoch, after all batches but before validation."""





Function ultralytics.utils.callbacks.base.on_fit_epoch_end#

def on_fit_epoch_end(trainer)

Called at the end of each fit epoch (train + val), after validation and any checkpoint save.

GitHubultralytics/utils/callbacks/base.py
def on_fit_epoch_end(trainer):
    """Called at the end of each fit epoch (train + val), after validation and any checkpoint save."""





Function ultralytics.utils.callbacks.base.on_model_save#

def on_model_save(trainer)

Called when the model checkpoint is saved, after validation.

GitHubultralytics/utils/callbacks/base.py
def on_model_save(trainer):
    """Called when the model checkpoint is saved, after validation."""





Function ultralytics.utils.callbacks.base.on_train_end#

def on_train_end(trainer)

Called when the training ends, after final evaluation of the best model.

GitHubultralytics/utils/callbacks/base.py
def on_train_end(trainer):
    """Called when the training ends, after final evaluation of the best model."""





Function ultralytics.utils.callbacks.base.on_params_update#

def on_params_update(trainer)

Called when the model parameters are updated. Reserved for custom integrations; not called by default.

GitHubultralytics/utils/callbacks/base.py
def on_params_update(trainer):
    """Called when the model parameters are updated. Reserved for custom integrations; not called by default."""





Function ultralytics.utils.callbacks.base.teardown#

def teardown(trainer)

Called during the teardown of the training process.

GitHubultralytics/utils/callbacks/base.py
def teardown(trainer):
    """Called during the teardown of the training process."""





Function ultralytics.utils.callbacks.base.on_val_start#

def on_val_start(validator)

Called when the validation starts.

GitHubultralytics/utils/callbacks/base.py
def on_val_start(validator):
    """Called when the validation starts."""





Function ultralytics.utils.callbacks.base.on_val_batch_start#

def on_val_batch_start(validator)

Called at the start of each validation batch.

GitHubultralytics/utils/callbacks/base.py
def on_val_batch_start(validator):
    """Called at the start of each validation batch."""





Function ultralytics.utils.callbacks.base.on_val_batch_end#

def on_val_batch_end(validator)

Called at the end of each validation batch.

GitHubultralytics/utils/callbacks/base.py
def on_val_batch_end(validator):
    """Called at the end of each validation batch."""





Function ultralytics.utils.callbacks.base.on_val_end#

def on_val_end(validator)

Called when the validation ends.

GitHubultralytics/utils/callbacks/base.py
def on_val_end(validator):
    """Called when the validation ends."""





Function ultralytics.utils.callbacks.base.on_predict_start#

def on_predict_start(predictor)

Called when the prediction starts.

GitHubultralytics/utils/callbacks/base.py
def on_predict_start(predictor):
    """Called when the prediction starts."""





Function ultralytics.utils.callbacks.base.on_predict_batch_start#

def on_predict_batch_start(predictor)

Called at the start of each prediction batch.

GitHubultralytics/utils/callbacks/base.py
def on_predict_batch_start(predictor):
    """Called at the start of each prediction batch."""





Function ultralytics.utils.callbacks.base.on_predict_batch_end#

def on_predict_batch_end(predictor)

Called at the end of each prediction batch.

GitHubultralytics/utils/callbacks/base.py
def on_predict_batch_end(predictor):
    """Called at the end of each prediction batch."""





Function ultralytics.utils.callbacks.base.on_predict_postprocess_end#

def on_predict_postprocess_end(predictor)

Called after the post-processing of the prediction ends.

GitHubultralytics/utils/callbacks/base.py
def on_predict_postprocess_end(predictor):
    """Called after the post-processing of the prediction ends."""





Function ultralytics.utils.callbacks.base.on_predict_end#

def on_predict_end(predictor)

Called when the prediction ends.

GitHubultralytics/utils/callbacks/base.py
def on_predict_end(predictor):
    """Called when the prediction ends."""





Function ultralytics.utils.callbacks.base.on_export_start#

def on_export_start(exporter)

Called when the model export starts.

GitHubultralytics/utils/callbacks/base.py
def on_export_start(exporter):
    """Called when the model export starts."""





Function ultralytics.utils.callbacks.base.on_export_end#

def on_export_end(exporter)

Called when the model export ends.

GitHubultralytics/utils/callbacks/base.py
def on_export_end(exporter):
    """Called when the model export ends."""





Function ultralytics.utils.callbacks.base.get_default_callbacks#

def get_default_callbacks()

Get the default callbacks for Ultralytics training, validation, prediction, and export processes.

Returns

TypeDescription
dictDictionary of default callbacks for various training events. Each key represents an event during the training process, and the corresponding value is a list of callback functions executed when that event occurs.

Examples

>>> callbacks = get_default_callbacks()
>>> print(list(callbacks.keys()))  # show all available callback events
['on_pretrain_routine_start', 'on_pretrain_routine_end', ...]
GitHubultralytics/utils/callbacks/base.py
def get_default_callbacks():
    """Get the default callbacks for Ultralytics training, validation, prediction, and export processes.

    Returns:
        (dict): Dictionary of default callbacks for various training events. Each key represents an event during the
            training process, and the corresponding value is a list of callback functions executed when that
            event occurs.

    Examples:
        >>> callbacks = get_default_callbacks()
        >>> print(list(callbacks.keys()))  # show all available callback events
        ['on_pretrain_routine_start', 'on_pretrain_routine_end', ...]
    """
    return defaultdict(list, deepcopy(default_callbacks))





Function ultralytics.utils.callbacks.base.add_integration_callbacks#

def add_integration_callbacks(instance)

Add integration callbacks to the instance's callbacks dictionary.

This function loads and adds analytics callbacks to every instance. Trainer instances also receive Platform and experiment logger callbacks for ClearML, Comet, DVC, MLflow, Neptune, Ray Tune, TensorBoard, and Weights & Biases.

Args

NameTypeDescriptionDefault
instanceTrainer | Predictor | Validator | ExporterThe object instance to which callbacks will be added. The type of instance determines which callbacks are loaded.required

Examples

>>> from ultralytics.engine.trainer import BaseTrainer
>>> trainer = BaseTrainer()
>>> add_integration_callbacks(trainer)
GitHubultralytics/utils/callbacks/base.py
def add_integration_callbacks(instance):
    """Add integration callbacks to the instance's callbacks dictionary.

    This function loads and adds analytics callbacks to every instance. Trainer instances also receive Platform and
    experiment logger callbacks for ClearML, Comet, DVC, MLflow, Neptune, Ray Tune, TensorBoard, and Weights & Biases.

    Args:
        instance (Trainer | Predictor | Validator | Exporter): The object instance to which callbacks will be added. The
            type of instance determines which callbacks are loaded.

    Examples:
        >>> from ultralytics.engine.trainer import BaseTrainer
        >>> trainer = BaseTrainer()
        >>> add_integration_callbacks(trainer)
    """
    from ultralytics.utils.events import callbacks as events_cb

    callbacks_list = [events_cb]

    # Load training callbacks
    if "Trainer" in instance.__class__.__name__:
        from .clearml import callbacks as clear_cb
        from .comet import callbacks as comet_cb
        from .dvc import callbacks as dvc_cb
        from .mlflow import callbacks as mlflow_cb
        from .neptune import callbacks as neptune_cb
        from .platform import callbacks as platform_cb
        from .raytune import callbacks as tune_cb
        from .tensorboard import callbacks as tb_cb
        from .wb import callbacks as wb_cb

        callbacks_list.extend([platform_cb, clear_cb, comet_cb, dvc_cb, mlflow_cb, neptune_cb, tune_cb, tb_cb, wb_cb])

    # Add the callbacks to the callbacks dictionary
    for callbacks in callbacks_list:
        for k, v in callbacks.items():
            if v not in instance.callbacks[k]:
                instance.callbacks[k].append(v)