# Instructor v1.15.4

Category: model-behavior
Published: 2026-06-28T07:36:13Z
Source: [Instructor releases](https://github.com/567-labs/instructor/releases/tag/v1.15.4)
Agent usefulness: 82/100
Confidence: 0.96
Content mode: release-watch
Verified: 2026-09-19T00:17:44.464Z
Tags: structured-output, validation, llm

## Human Summary
Instructor releases published Instructor v1.15.4. What's Changed Instructor 1.15.4 is a patch release that consolidates the latest small fixes and docs cleanup after 1.15.3 . Runtime Fixes - Fixed v2 response-model preparation so list and primitive response models are normalized before provider handler dispatch. This fixes crashes such as AttributeError:…

## Agent Summary
Treat Instructor v1.15.4 as an official release signal. Inspect the linked changelog for compatibility and migration details, then run targeted tests before upgrading.

## Body
Instructor releases published Instructor v1.15.4. This release-watch entry was generated from the project's official GitHub release feed and is kept separate from human-reviewed editorial analysis. Release notes: What's Changed Instructor 1.15.4 is a patch release that consolidates the latest small fixes and docs cleanup after 1.15.3 . Runtime Fixes - Fixed v2 response-model preparation so list and primitive response models are normalized before provider handler dispatch. This fixes crashes such as AttributeError: type object 'list' has no attribute 'model json schema' for list Model and scalar response models. - Fixed streamed JSON extraction so backticks inside JSON string values are preserved instead of being interpreted as markdown fence delimiters. - Fixed Image.autodetect() to accept raw JPEG, PNG, GIF, and WebP bytes, while raising clear errors for unsupported image inputs. - Added regression coverage for the existing Gemini empty-message path. - Fixed list BaseModel simple-type detection so model lists route through iterable handling instead of scalar wrapping. CLI - Fixed fine-tuning…

## Recommended actions
- Review the official Instructor releases release notes before upgrading.
- Check compatibility, migration, and security notes against your current agent stack.
- Run focused regression tests before production rollout.

## Sponsors
No sponsor placement attached.

## Agent-readable Sponsor Surface
Sponsor inventory is available at /api/sponsors.json with useCases, pricing, API/docs URLs, targetAgents, constraints, CTA URL, commercial disclosure fields, sourceOfTruthUrl, constraintsLastVerifiedAt, constraintsRefreshCadence, driftHandlingPolicy, and constraintPolicy.