# What changed in @huggingface/transformers

> 25 changes in @huggingface/transformers 4 from its official release notes, upgrade guides and advisories: 2 breaking, 9 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/@huggingface/transformers/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @huggingface/transformers 4

### Breaking changes

- For EmbeddingGemma 2, the feature-extraction pipeline returns normalized embeddings, making their dot product equal to cosine similarity. (4.3.1) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.1)
- Generation now always sets this parameter to `1`. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)

### New APIs and options

- Exposes getSupportedDevices() under env.backends.onnx. (4.3.2) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.2)
- Adds support for LFM3 models. (4.3.2) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.2)
- Adds support for LFM3-VL models. (4.3.2) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.2)
- Adds support for EmbeddingGemma 2, a multimodal embedding model that maps text, images, video, and audio into a shared vector space. (4.3.1) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.1)
- Adds support for the DeepSeek-V4 model architecture. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Adds support for the HRM-Text model architecture. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Adds an experimental, dependency-free package for constraining generation to a JSON schema, JSON object, or regular expression. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Provides a logits processor for constraining generated output using a JSON schema, JSON object, or regular expression. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Adds support for the Zaya model architecture. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)

### Performance

- The KV cache is disposed of after generation. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)

### Behavior and default changes

- Cross-Origin Storage now allows all origins. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Cross-Origin Storage now uses `requestFileHandle()`. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Enables WebGPU support for Safari 26 and above. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)

### Fixes and other changes

- External data download failures no longer cause from_pretrained to hang. (4.3.2) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.2)
- Fixes handling of negative integer random seeds. (4.3.2) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.2)
- Browser cache writes are skipped for non-HTTP(S) resources. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Restores missing global exports. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Fixes the number of features in the processor. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Fixes token decoding for Moonshine ASR. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Fixes duplicate model file downloads when this callback is active. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Fixes `toBlob()` so it respects typed-array byte offsets and lengths. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Pins the WebGPU KV cache for Gemma3n and Gemma4 image-audio-text-to-text models. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)
- Fixes progress callbacks for Whisper. (4.3.0) — [release notes](https://github.com/huggingface/transformers.js/releases/tag/4.3.0)