Change8

Migrating to LlamaIndex v0.14.3

Version v0.14.3 introduces 2 breaking changes. This guide details how to update your code.

Released: 9/24/2025

2
Breaking Changes
2
Migration Steps
11
Affected Symbols

⚠️ Check Your Code

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

ThinkingBlockGeminiFirecrawlReaderPaddleOCRReaderAzurePostgreSQLVectorStoreMongoReaderMongoChatStoreMongoKVStoreValyuExtractorQdrantVectorStoreSingleStoreVectorStore

Breaking Changes

Issue #1

The MongoDB-related packages (readers, chat-store, kvstore) have migrated from the Motor library to the PyMongo Asynchronous API. This may break custom implementations relying on Motor-specific objects.

Issue #2

The Firecrawl web reader has been migrated to the Firecrawl v2 SDK, which may involve breaking changes in configuration or response schemas.

Migration Steps

  1. 1
    Update MongoDB-based integrations to ensure compatibility with the PyMongo Asynchronous API instead of Motor.
  2. 2
    Upgrade Firecrawl SDK to v2 when using llama-index-readers-web.

Release Summary

This release introduces ThinkingBlock support across major LLM providers, adds new PaddleOCR and Azure PostgreSQL integrations, and migrates MongoDB components to the PyMongo Asynchronous API. It also includes a critical security fix for SingleStoreDB and updates the Firecrawl reader to the v2 SDK.

Need More Details?

View the full release notes and all changes for LlamaIndex v0.14.3.

View Full Changelog