●Change8

Migrating to XGBoost v3.0.1

Version v3.0.1 introduces 1 breaking change. This guide details how to update your code.

Released: 5/13/2025

1
Breaking Changes
3
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

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

xgboost.DMatrixxgboost.Boosterxgboost.rxgboost.dask

Breaking Changes

●Issue #1

Model files now store denormal floating-point values instead of NaN, which may break code that expects NaN in the output. Update downstream parsing or checks to handle denormal values.

Migration Steps

  1. 1
    If your workflow relies on NaN values in model output, adjust code to accept denormal floating-point numbers.
  2. 2
    Upgrade to the new `xgboost-cpu` manylinux_2_28_x86_64 wheel for Linux x86_64 environments.
  3. 3
    For R users, download the new experimental CUDA-enabled binary package if needed.

Release Summary

This release adds GPU driver detection, deep-tree external-memory optimizations, new manylinux_2_28_x86_64 CPU wheels, Dask compatibility workarounds, and changes model output to use denormal floating-point values, along with several bug fixes.

Need More Details?

View the full release notes and all changes for XGBoost v3.0.1.

View Full Changelog