●Change8

Migrating to Unsloth v0.1.405-beta

Version v0.1.405-beta introduces 2 breaking changes. This guide details how to update your code.

Released: 5/18/2026

2
Breaking Changes
6
Migration Steps
15
Affected Symbols

⚠️ Check Your Code

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

llama.cpptorch.loadtraining_args.binnum_logits_to_keepfast_generateLOSS_MAPPINGForCausalLMLossgrouped_mmHF_DATASETS_OFFLINEHF_HUB_OFFLINEflash-attnflash-linear-attentiontilelangQwen3.5 familysentence-transformers

Breaking Changes

●Issue #1

Removed the `torch.load` fallback on `training_args.bin`. Untrusted pickles can no longer execute on model load, which may break workflows relying on this fallback.

●Issue #2

Cross-family GGUF projector is now blocked in flat local directories, preventing wrong-vision-tower loads. If you were loading cross-family models from flat directories, this might fail.

Migration Steps

  1. 1
    If you rely on `torch.load` fallback for `training_args.bin`, ensure your pickles are trusted or update your loading mechanism.
  2. 2
    If you were loading cross-family GGUF models from flat local directories, reorganize your structure or ensure the projector loading is handled correctly.
  3. 3
    If using older Unsloth versions, ensure you are using `v0.1.405-beta` or newer, not `v0.1.40-beta`.
  4. 4
    If installing or running Unsloth Studio, consider setting `STUDIO_HOME` or `UNSLOTH_STUDIO_HOME` if you require a custom installation path.
  5. 5
    Users on Windows should see improved CUDA installation due to paired `cudart` bundle and Torch NVIDIA DLL paths being added to `PATH`.
  6. 6
    Users on Ubuntu 24.04 building HIP source should ensure `--gcc-install-dir` is injected if necessary.

Release Summary

This release brings significant performance gains, up to 2x faster GGUF inference via MTP speculative decoding, and introduces extensive API provider support with built-in tools like web search and code execution. Security has been heavily hardened across the Studio platform, alongside numerous training and installer reliability fixes.

Need More Details?

View the full release notes and all changes for Unsloth v0.1.405-beta.

View Full Changelog