●Change8

Migrating to Instructor 1.9.0

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

Released: 6/21/2025

2
Breaking Changes
3
Migration Steps
9
Affected Symbols

⚠️ Check Your Code

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

AnthropicVertexAIOllamaWriterreask_anthropic_jsondump_messageThinkingBlockAudiogenai

Breaking Changes

●Issue #1

The `enable_prompt_caching` parameter has been removed from the Anthropic integration. Users should remove this argument from their function calls as it is no longer supported in the current implementation.

●Issue #2

Async parameter naming in the VertexAI client has been standardized, which may require updating parameter names in existing VertexAI async calls.

Migration Steps

  1. 1
    Remove `enable_prompt_caching` from any Anthropic client calls.
  2. 2
    Update VertexAI async calls to match the new standardized parameter naming.
  3. 3
    Update dependency constraints if using google-genai or rich.

Release Summary

This release introduces Ollama and Writer provider support, improves Gemini and Anthropic integrations, and standardizes VertexAI async parameters. It also enhances error handling with a new exception hierarchy and resolves several dependency conflicts.

Need More Details?

View the full release notes and all changes for Instructor 1.9.0.

View Full Changelog