Change8
Error1 reports

Fix JSONDecodeError

in Instructor

Solution

JSONDecodeError usually arises when instructor receives a string that isn't valid JSON, often due to incorrect data types or malformed responses from external APIs or models. Ensure that the data being passed to instructor's `from_response` or similar methods is a valid JSON string or a Python dictionary that can be serialized to JSON. If dealing with API responses, double-check the API endpoint is returning valid JSON and handle potential encoding issues.

Related Issues

Real GitHub issues where developers encountered this error:

Timeline

First reported:Nov 6, 2025
Last reported:Nov 6, 2025

Need More Help?

View the full changelog and migration guides for Instructor

View Instructor Changelog