---
title: "fastembed Breaking Changes on PyPI | Since.dev"
description: "What each fastembed release removed, renamed or changed: 23 breaking changes in 1 version on PyPI, each with its source."
canonical_url: https://since.dev/packages/pypi/fastembed
last_updated: 2026-10-07
---

# fastembed breaking changes

Every breaking API change we have recorded in fastembed on PyPI: 23 breaking changes in 1 version. Below are its newest version, removals and renames first, each with its source.

Newest change October 7, 2026

## 0.9.0

23 breaking changes, first published October 7, 2026.

- **Removed** `fastembed.sparse.if_splade.iter_batch`  

fastembed.sparse.if_splade.iter_batch was removed in fastembed 0.9.0 [pypi.org](https://pypi.org/project/fastembed/0.9.0/)
- **Removed** `fastembed.sparse.if_splade.load_tokenizer`  

fastembed.sparse.if_splade.load_tokenizer was removed in fastembed 0.9.0 [pypi.org](https://pypi.org/project/fastembed/0.9.0/)
- **Behavior changed**  

The model now loads model_v2.onnx and removes padding rows from its embeddings, so offline setups must download it first and images embedded in mixed-aspect-ratio batches should be re-embedded. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

MUVERA encoding of an empty multivector now raises a ValueError instead of returning a result. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

Truncation and padding side now come from the model's tokenizer config, which can change token outputs for affected models. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

Passing a batch_size below 1 now raises a ValueError, so code that passed such values will fail. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

Token limits were raised for some models on fresh downloads, so embeddings of long texts change. Cached models keep the old limit until deleted from the cache. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

Embeddings from mean-pooling text models are now float32, so code relying on float64 output must adjust. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

Built-in models no longer fall back to Google Cloud Storage when Hugging Face is unavailable. Cached GCS copies still load offline, and users should load each model once online before relying on offline use. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)
- **Behavior changed**  

Center-crop preprocessing was changed, so image embeddings for some sizes differ from earlier versions. [github.com](https://github.com/qdrant/fastembed/releases/tag/v0.9.0)

And 13 more in this version.

## Check your code

These are the changes. To see which of them reach your code, [scan a public repository](https://since.dev/scan.md), or have your coding agent call `check_code` with your manifest or lockfile over [MCP](https://since.dev/docs.md#mcp). [The API](https://since.dev/docs.md#api) reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.

## Put your code on continuous management.

Scan a public repository now, or give your agent one line.

### See how out of date your code is.

[Scan a repository](https://since.dev/scan.md). Any public GitHub repository. No sign-in.

### Tell your agent what changed since it was trained.

`claude mcp add --transport http since https://api.since.dev/mcp`

---

Every page on this site as Markdown: https://since.dev/sitemap.md. For agents: https://since.dev/llms.txt.