●Change8

Migrating to LlamaIndex v0.14.0

Version v0.14.0 introduces 7 breaking changes. This guide details how to update your code.

Released: 9/8/2025

7
Breaking Changes
4
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

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

Workflow.send_eventWorkflow.stream_eventsWorkflowRuntimeErrorContext.send_eventContext.stream_eventsllama-index-workflowsllama-index-core

Breaking Changes

●Issue #1

llama-index-workflows bumped to 2.0 with several removals.

●Issue #2

WorkflowRuntimeError no longer wraps errors to improve stacktrace clarity.

●Issue #3

Removed checkpointer feature from workflows.

●Issue #4

Removed sub-workflows feature.

●Issue #5

Removed send_event() method from the Workflow class (use Context.send_event instead).

●Issue #6

Removed stream_events() method from the Workflow class (use Context.stream_events instead).

●Issue #7

Removed support for stepwise execution in workflows.

Migration Steps

  1. 1
    Update code to access send_event() and stream_events() via the Context class instead of the Workflow class.
  2. 2
    Refactor workflows that relied on the deprecated checkpointer or sub-workflows features.
  3. 3
    Remove any logic dependent on stepwise execution in workflows.
  4. 4
    Update llama-index-core to 0.14.0 and llama-index-llms-openai to 0.5.6.

Release Summary

This release updates llama-index-core to 0.14.0, introducing breaking changes in workflows by removing deprecated features and methods, while adding document block support for OpenAI LLMs.

Need More Details?

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

View Full Changelog