●Change8

Migrating to MLflow v3.7.0

Version v3.7.0 introduces 3 breaking changes. This guide details how to update your code.

Released: 12/5/2025

3
Breaking Changes
5
Migration Steps
11
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

mlflow.genai.evaluatemake_judgemlflow.scorers.listSqlLoggedModelMetricLoggedModelOutput.to_dictionarymlflow.models.divinermlflow.models.promptflowmlflow.gc_delete_trace_tag_v3mlflow.trackingmlflow.tracing

Breaking Changes

●Issue #1

Tracking: SQLite is now the default backend for the MLflow Tracking server. Projects using a different default backend need to update their configuration or migrate existing data to SQLite.

●Issue #2

Models: The deprecated `diviner` flavor has been removed. Code referencing `mlflow.models.diviner` must be updated to use a supported flavor.

●Issue #3

Models: The deprecated `promptflow` flavor has been removed. Remove any usage of `mlflow.models.promptflow` or replace with an alternative.

Migration Steps

  1. 1
    If you rely on a non‑SQLite tracking backend, update your `MLFLOW_TRACKING_URI` or migrate existing tracking data to SQLite, as SQLite is now the default backend.
  2. 2
    Remove any usage of the deprecated `diviner` and `promptflow` model flavors and replace them with supported alternatives.
  3. 3
    Ensure your environment does not use Click version 8.3.0 (upgrade to a different version) due to the new pinning constraint.
  4. 4
    Verify that parent directories for SQLite database files exist or rely on the new automatic creation feature.
  5. 5
    Review and configure authentication for scorers now that auth support has been added.

Release Summary

MLflow 3.7.0 adds major GenAI observability features such as an Experiment Prompts UI, multi-turn evaluation, trace comparison, and new auto-tracing SDKs, while introducing breaking changes like SQLite becoming the default tracking backend and removal of deprecated model flavors. It also includes numerous bug fixes and enhancements across tracking, evaluation, tracing, and UI components.

Need More Details?

View the full release notes and all changes for MLflow v3.7.0.

View Full Changelog