Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

Instructor

Python library to get structured outputs from language models with validation and parsing.

Prompts, structured output and evalsPYPI

GitHub

1. License

License from PyPI license field.

github.com/567-labs/instructor

From the package registry and GitHub, checked daily. Tap a verdict to see its source.How we checkedReport an error

What Instructor does

Python library to get structured outputs from language models with validation and parsing.

Instructor popularity

62 / 100
Gid Score, #792 overall
2.5M
downloads a week, pypi
14.1K
GitHub stars
4
agent projects use it
Instructor: downloads per weekPyPI, instructor 2,497,550
Instructor: GitHub stars567-labs/instructor 14,117

Gid Score measures public popularity and activity, not quality. How the Gid Score is calculated

How Instructor is used

  • Instructor is a dependency in 4 of the 6,254 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 3,063, Ethereum and EVM 1,777, 3D and games 3,120, agent frameworks and SDKs 13,629); counting those, it appears in 172 projects, and what it is used with below comes from all of them.
  • The most used alternative in our scan is DSPy (6 projects).
  • Projects that use it most often also use Pydantic (90.7%), OpenAI Python Library (90.1%), NumPy (87.8%).

Often used with

In 90.7% of its projects
In 90.1% of its projects
In 87.8% of its projects
In 87.2% of its projects
In 83.1% of its projects
In 82.0% of its projects
In 80.2% of its projects
In 77.9% of its projects

More about Instructor

Funding
  • GitHub Sponsors: https://github.com/jxnl
  • 3 GitHub sponsors

See all

Agent Skills for it
  • instructor: Extract structured data from LLM responses with Pydantic validation, retry failed extractions automatically, parse complex JSON with type sa

See all

More in Prompts, structured output and evals

Alternatives

Instructor This page

MITGid 622.5M/wk

DSPy

Framework for optimizing LLM prompts and pipelines systematically.

MITGid 631.5M/wk

Compare Instructor with another tool

Get started

Install it.

pip install instructor

No step-by-step start for Instructor yet: we have not written its hand-checked card.