NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #830 most downloaded on PyPI
structured outputs for llm
Last release 23 days ago
09 Sep 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
98 releases · first in 2023
One column per quarter.
Add support for cohere models by @lidiyam in https://github.com/jxnl/instructor/pull/585
Full Changelog: https://github.com/jxnl/instructor/compare/1.1.0...1.2.0
docs: fixes few typos in validation-part1 by @rishabgit in https://github.com/jxnl/instructor/pull/572
Full Changelog: https://github.com/jxnl/instructor/compare/1.0.3...1.1.0
@jd-solanki made their first contribution in https://github.com/jxnl/instructor/pull/570
Full Changelog: https://github.com/jxnl/instructor/compare/1.0.2...1.0.3
feat: Partial jiter by @jxnl in https://github.com/jxnl/instructor/pull/563
Full Changelog: https://github.com/jxnl/instructor/compare/1.0.1...1.0.2
refactor(OpenAISchema): improve from_response readability and update tests by @jxnl in https://github.com/jxnl/instructor/pull/543
from_response readability and update tests by @jxnl in https://github.com/jxnl/instructor/pull/543Full Changelog: https://github.com/jxnl/instructor/compare/0.6.8...1.0.0
Add optional dependencies for anthropic and xmltodict by @jpetrantoni in https://github.com/jxnl/instructor/pull/519
I know mypy is broken...
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.7...0.6.8
fixed import error Full Changelog: https://github.com/jxnl/instructor/compare/0.6.6...0.6.7
fixed import error
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.6...0.6.7
fix: clean up imports for anthropic by @jxnl in https://github.com/jxnl/instructor/pull/517
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.5...0.6.6
Adds link to InstructorGPT by @Evanc123 in https://github.com/jxnl/instructor/pull/499
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.4...0.6.5
fix: updated deprecated pydantic import by @zboyles in https://github.com/jxnl/instructor/pull/494
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.3...0.6.4
fix: examples/citation_with_extraction/citation_fuzzy_match.py is out of sync with the website by @superkelvint in https://github.com/jxnl/instructor/
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.2...0.6.3
doc: Move partial and iterable from cookbook/examples to hub by @ethanleifer in https://github.com/jxnl/instructor/pull/452
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.1...0.6.2
cookbook: competitors matrix example for image extraction by @fpingham in https://github.com/jxnl/instructor/pull/346
Full Changelog: https://github.com/jxnl/instructor/compare/0.6.0...0.6.1
We're thrilled to announce the release of Version 0.6.0 for instructor. This version introduces a myriad of enhancements, new features, and critical f
We're thrilled to announce the release of Version 0.6.0 for instructor. This version introduces a myriad of enhancements, new features, and critical fixes that significantly improve the developer experience. Here's what's new:
llama-cpp-python and instructor library usage, offering insights and best practices.feat(Instructor): integrate with SQLModel, providing seamless integration, along with comprehensive documentation and examples.A special shoutout to our new contributors @ryanhalliday, @teome, @leobeeson, and @shiftbug for their valuable additions to the project.
We're excited for you to try out the new features and improvements in Version 0.6.0. Your feedback is invaluable to us, so please don't hesitate to share your thoughts and experiences as you explore this release. Happy coding!
llama-cpp-python and instructor library usage by @jxnl in https://github.com/jxnl/instructor/pull/434Full Changelog: https://github.com/jxnl/instructor/compare/0.5.2...0.6.0
chore(pull_request_template): update to include conventional commits instructions by @jxnl in https://github.com/jxnl/instructor/pull/411
Full Changelog: https://github.com/jxnl/instructor/compare/0.5.1...0.5.2
Be robust to null values while updating token counts by @indigoviolet in https://github.com/jxnl/instructor/pull/359
List[Union[T]] by @jxnl in https://github.com/jxnl/instructor/pull/378Full Changelog: https://github.com/jxnl/instructor/compare/0.4.8...0.5.0
Adding support for caching async functions by @ivanleomk in https://github.com/jxnl/instructor/pull/340
Full Changelog: https://github.com/jxnl/instructor/compare/0.4.7...0.4.8
Update function call mode and add deprecation warning by @Phodaie in https://github.com/jxnl/instructor/pull/337
Improvements with field streaming and usage tokens
total_usage variable to track cumulative token usage by @lazyhope in https://github.com/jxnl/instructor/pull/343Full Changelog: https://github.com/jxnl/instructor/compare/0.4.6...0.4.7
Update README.md by @lakshyaag in https://github.com/jxnl/instructor/pull/291
Maybe typing by @dalberto in https://github.com/jxnl/instructor/pull/325Full Changelog: https://github.com/jxnl/instructor/compare/0.4.5...0.4.6
Update anyscale.md by @robertnishihara in https://github.com/jxnl/instructor/pull/285
Full Changelog: https://github.com/jxnl/instructor/compare/0.4.3...0.4.5
Nothing published for this version
Add logging.error for Retry logic by @jxnl in https://github.com/jxnl/instructor/pull/259
Full Changelog: https://github.com/jxnl/instructor/compare/0.4.2...0.4.3
Opensource examples - Runpod w/Text-Generation-WebUI API Endpoint by @PhiBrandon in https://github.com/jxnl/instructor/pull/247
Full Changelog: https://github.com/jxnl/instructor/compare/0.4.1...0.4.2
Multitask is swapped with Iterable[T]
Many Improvements were made:
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.5...0.4.0
Spelling fix - chain-of-density.md by @mitch-36 in https://github.com/jxnl/instructor/pull/176
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.4...0.3.5
Fix typo by @Xeophon in https://github.com/jxnl/instructor/pull/173
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.3...0.3.4
Added support for model suffix and added migrations for new OpenAI SDK by @ivanleomk in https://github.com/jxnl/instructor/pull/169
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.2...0.3.3
small typo fix by @bnkc in https://github.com/jxnl/instructor/pull/160
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.1...0.3.2
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.0...0.3.1 FIxed issues with classmethod
Full Changelog: https://github.com/jxnl/instructor/compare/0.3.0...0.3.1
FIxed issues with classmethod
```py hl_lines="5 13" from openai import OpenAI() import instructor
from openai import OpenAI()
import instructor
# Enables `response_model`
client = instructor.patch(OpenAI())
class UserDetail(BaseModel):
name: str
age: int
user = client.chat.completions.create(
model="gpt-3.5-turbo",
response_model=UserDetail,
messages=[
{"role": "user", "content": "Extract Jason is 25 years old"},
]
)
assert isinstance(user, UserDetail)
assert user.name == "Jason"
assert user.age == 25
openai<1.0.0"If you're using openai<1.0.0 then make sure you pip install instructor<0.3.0
where you can patch a global client like so:
import openai
import instructor
instructor.patch()
user = openai.ChatCompletion.create(
...,
response_model=UserDetail,
)
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.11...0.3.0
Add File Validation and Hyperparameters Support to CLI by @daaniyaan in https://github.com/jxnl/instructor/pull/151
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.10...0.2.11
Expose unpatch() function by @NISH1001 in https://github.com/jxnl/instructor/pull/114
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.8...0.2.9
Reasking logic on validations by @jxnl in https://github.com/jxnl/instructor/pull/98
pngquant in MkDocs Pipeline for correct image optimization by @jlondonobo in https://github.com/jxnl/instructor/pull/112Full Changelog: https://github.com/jxnl/instructor/compare/0.2.7...0.2.8
Maybe helper to dynamically create a class with errors on extraction by @jxnl in https://github.com/jxnl/instructor/pull/95
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.6...0.2.7
Add citations examples by @jxnl in https://github.com/jxnl/instructor/pull/88
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.5...0.2.6
update message assignment by @neilneuwirth in https://github.com/jxnl/instructor/pull/80
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.4...0.2.5
Rename to Instructor by @jxnl in https://github.com/jxnl/instructor/pull/79
Full Changelog: https://github.com/jxnl/instructor/compare/0.2.3...0.2.4
Implement streaming entities via MultiTask by @jxnl in https://github.com/jxnl/openai_function_call/pull/64
Full Changelog: https://github.com/jxnl/openai_function_call/compare/0.2.0...0.2.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →