This patch release adds support for the full Transformers v5 release.

Install this version with

# Training + Inference
pip install sentence-transformers[train]==5.2.1

# Inference only, use one of:
pip install sentence-transformers==5.2.1
pip install sentence-transformers[onnx-gpu]==5.2.1
pip install sentence-transformers[onnx]==5.2.1
pip install sentence-transformers[openvino]==5.2.1

Transformers v5 Support

Sentence Transformers v5.2.0 already introduced support for the Transformers v5.0 release candidates, but this release is adding support for the full release. The intention is to maintain backward compatibility with v4.x. The library includes dual CI testing for both version for now, allowing users to upgrade to the newest Transformers features when ready. In future versions, Sentence Transformers may start requiring Transformers v5.0 or higher.

All Changes

• Introduce compatibility with transformers 5.0.0rc01 by @tomaarsen (https://github.com/huggingface/sentence-transformers/pull/3597)
• Specify numpy manually in dependencies, as it's directly used/imported by @tomaarsen (https://github.com/huggingface/sentence-transformers/pull/3608)
• Expand test suite to full transformers v5 by @tomaarsen (https://github.com/huggingface/sentence-transformers/pull/3615)

Full Changelog: https://github.com/huggingface/sentence-transformers/compare/v5.2.0...v5.2.1