●Change8

Migrating to Transformers v5.5.0

Version v5.5.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/2/2026

2
Breaking Changes
2
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

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

Gemma 4 (New Model)NomicBERT (New Model)Music Flamingo (New Model)LightGlueGemma vision maskJanus image generationTokenizersImage ProcessorsLM head weightsQwen3.5 MoESwitchTransformersTimmWrapperModelT5AttentionAutoConfig.from_pretrained

Breaking Changes

●Issue #1

Mamba and hybrid model caches must now use the new native cache classes; previous workarounds for Mamba-based or hybrid models are obsolete.

●Issue #2

Remote code execution support has been removed from the native LightGlue integration. Users loading LightGlue must remove the `trust_remote_code=True` argument and use the model via the standard native API.

Migration Steps

  1. 1
    Update code to use native cache classes for Mamba-based or hybrid models instead of previous workarounds.
  2. 2
    Remove `trust_remote_code=True` when loading LightGlue and use the model directly through the standard native API.

Release Summary

This release introduces three major new models: Gemma 4 (multimodal), NomicBERT (long-context text embedding), and Music Flamingo (audio-language). It also includes significant breaking changes related to native cache handling for Mamba models and security updates for LightGlue.

Need More Details?

View the full release notes and all changes for Transformers v5.5.0.

View Full Changelog