Change8

Migrating to DSPy 2.6.0

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

Released: 1/30/2025

2
Breaking Changes
3
Migration Steps
12
Affected Symbols

⚠️ Check Your Code

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

functionaldspSettingsStreamBootstrapFTinterpreterLiteLLM.RetryPolicyChatAdapterJSONAdapterdspy.ReActmath_datasetmulti_chain_comparison

Breaking Changes

Issue #1

Removed deprecated `functional/` and `dsp/` client modules and old cache implementations; import paths and usage must be updated to the new modules.

Issue #2

Python interpreter refactor to a sandboxed environment may change execution behavior; code that relied on direct interpreter access should be reviewed and adapted to the sandbox API.

Migration Steps

  1. 1
    Replace imports of `functional` and `dsp` clients with the new module paths or alternative implementations.
  2. 2
    If your code interacts directly with the Python interpreter, migrate to the new sandbox API as described in the migration guide.
  3. 3
    Review any custom retry logic and switch to using LiteLLM `RetryPolicy` where appropriate.

Release Summary

This release removes deprecated functional and dsp clients, adds streaming, a sandboxed interpreter, retry support, and several feature enhancements while fixing literal handling bugs.

Need More Details?

View the full release notes and all changes for DSPy 2.6.0.

View Full Changelog