●Change8

Migrating to Instructor v1.11.0

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

Released: 8/27/2025

2
Breaking Changes
3
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

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

instructor.from_providerinstructor.utilsinstructor.batchinstructor.hooksinstructor.auto_clientConfigDictcompletion:errorcompletion:last_attempt

Breaking Changes

●Issue #1

The codebase has been reorganized from a flat structure to a modular architecture, which may affect internal imports.

●Issue #2

Backward compatibility modules have been removed. Users relying on legacy import paths must update to the current modular structure.

Migration Steps

  1. 1
    Update import statements to reflect the new modular architecture if you were importing from internal utility paths.
  2. 2
    Remove usage of legacy backward compatibility modules.
  3. 3
    Update Pydantic models from 'class Config' to 'model_config = ConfigDict(...)'.

Release Summary

This release introduces a major modular reorganization of the codebase, adds support for xAI, OpenRouter, and Truefoundry providers, and implements in-memory batching.

Need More Details?

View the full release notes and all changes for Instructor v1.11.0.

View Full Changelog