
Instructor
An open-source Python library that gets structured, validated output from LLMs by defining the result as a Pydantic model, with automatic retries when validation fails, across OpenAI, Anthropic, Gemini and other providers.
32 open-source projects declare Instructor in their code; no maker's live product we track uses it yet.
Profile checked
How makers use Instructor
What Instructor is used for
Instructor vs the alternatives makers chose
| Option | Makers' products | Open source | |
|---|---|---|---|
| 66 57% | Yes | ||
| 24 21% | Yes | ||
| 16 14% | Yes | ||
| 5 4% | Yes | ||
| 3 3% | Yes | ||
| 1 1% | Yes | ||
| 0 0% | Yes |
For AI SDK & agent framework: how many of the 115 makers' products we know the AI SDK & agent framework of chose each option.
When to use Instructor, and when not
Something else fits better if
- Your app is TypeScript and you want agents without adding a Python service: AI SDK or Mastra.
- You want a small typed agent loop in Python, close to the raw API: Pydantic AI or OpenAI Agents SDK.
- Your agent works on files and runs commands, like a coding or research agent: Claude Agent SDK.
- You need many prebuilt connectors for models, tools and data sources: LangChain.
- Your agent is a long-running workflow with branches, saved state and human approval steps: LangGraph.
Who uses it
No maker's live product on record yet, and 32 open-source projects that declare it in their code.
We haven't found a maker's live product that uses Instructor yet — only the open-source projects below, which declare it in their code.
None of these in makers' own words.
Open source: a project that declares Instructor as a dependency in its public code — verifiable, but not necessarily a live product.
Alternatives to Instructor
All alternatives by situation →Further reading
Questions makers ask about Instructor
What are the alternatives to Instructor?
For AI SDK & agent framework, the other options makers' products we track chose most are LangChain (66), Mastra (24), LlamaIndex (16), AI SDK (5), CrewAI (3), LangGraph (1). Open source or self-hostable among them: LangChain, Mastra, LlamaIndex, AI SDK, CrewAI, LangGraph. Each alternative, with the situation it fits, is on the Instructor alternatives page.
Is Instructor free?
Yes — it is free, open-source software.
Is Instructor open source or self-hostable?
Open source, and you can self-host it. source ↗
Can AI coding agents work with Instructor?
No llms.txt, official MCP server or CLI found yet.
Who uses Instructor?
No maker's live product we track yet; 32 open-source projects declare it in their code. source ↗