●Change8

Migrating to LlamaIndex v0.12.50

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

Released: 7/19/2025

2
Breaking Changes
2
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

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

MarkdownElementNodeParserget_cache_dirSQLAlchemyChatStoreDocumentContextExtractorBaseDocumentStoreVectorMemoryBlockGoogleGenAIWikipediaToolSpec.load_dataBaiduVectorDBMoorchehVectorStore

Breaking Changes

●Issue #1

The `get_cache_dir()` function now uses a more secure default location, which may change where your application stores or looks for cached data.

●Issue #2

NLTK cache is now stored in a private folder, potentially requiring re-downloading of NLTK data if you relied on global paths.

Migration Steps

  1. 1
    If you rely on specific cache locations, verify the new path used by `get_cache_dir()`.
  2. 2
    Update Bedrock Converse implementations if using Llama 3.2 1b/3b for function calling, as these are no longer listed as supported for that feature.

Release Summary

This release introduces several new integrations including Cloudflare AI Gateway, Service-Now, and S3 vector stores, alongside Llama 4 support in Bedrock. It also includes security improvements to cache directory handling and various bug fixes for agents and retrievers.

Need More Details?

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

View Full Changelog