Updated

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.

Open sourceSelf-hostableFree tier

Profile checked

Ask your AI about this, with this page as the source:ChatGPT ↗Claude ↗Perplexity ↗

How makers use Instructor

What Instructor is used for

AI SDK & Agent Framework · Thin SDK →Getting validated structured output from any major LLM by declaring a Pydantic model, with retries on validation errors.Trade-off: Structured output only, with no agent loop, memory or tool orchestration; the TypeScript port has not been released since January 2025.
LangChain66Mastra24LlamaIndex16AI SDK5CrewAI3Instructor0Makers' products on each, for AI SDK & agent framework

Instructor vs the alternatives makers chose

OptionMakers' productsOpen source
LangChain66 57%Yes
Mastra24 21%Yes
LlamaIndex16 14%Yes
AI SDK5 4%Yes
CrewAI3 3%Yes
LangGraph1 1%Yes
Instructor0 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.
From each decision's guide, written from what makers' products chose and why.

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.

ArcReel
ArcReelAI Agent 驱动的开源可自部署视频工作台:将小说与剧本转为角色、场景、道具资产、分镜、视频和剪映草稿,支持跨镜头一致性、多供应商与费用追踪 | Self-hosted A…AI SDK & Agent FrameworkIn its code · source ↗
Paid
PaidBilling platform for AI agents that meters agent events into value-based units, prices a…AI SDK & Agent FrameworkIn its code · source ↗
Ragas
RagasOpen-source Python library for evaluating LLM and RAG applications, with metrics such as…AI SDK & Agent FrameworkIn its code · source ↗
farfalle
farfalleGone · domain now runs another site, Oct 2026🔍 AI search engine - self-host with local or cloud LLMsAI SDK & Agent FrameworkIn its code · source ↗

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 ↗