Change8

Migrating to Unsloth June-2025

Version June-2025 introduces 2 breaking changes. This guide details how to update your code.

Released: 6/26/2025

2
Breaking Changes
1
Migration Steps
9
Affected Symbols

⚠️ Check Your Code

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

SFTConfigWhisperSesame-CSMOrpheus-TTSDeepSeek-R1-0528-Qwen3Magistral-24BGemma3 vision modelsLoraConfigtrl.SFTTrainer

Breaking Changes

Issue #1

Removed `dataset_text_field` from `SFTConfig`. Users should ensure they are not relying on this field being present.

Issue #2

The SFTTrainer now favors `max_seq_length` over `max_length` in its configuration. If you explicitly set both, ensure `max_seq_length` is the intended value for sequence length.

Migration Steps

  1. 1
    Update Unsloth via `pip install --upgrade --force-reinstall unsloth unsloth_zoo`.

Release Summary

This release introduces major new capabilities including support for multimodal Gemma 3n models and Text-to-Speech fine-tuning, alongside new quantization methods (Dynamic 2.0 GGUFs) and support for DeepSeek-R1-0528 and Magistral-24B.

Need More Details?

View the full release notes and all changes for Unsloth June-2025.

View Full Changelog