Instructor

What is Instructor?

Instructor is an open-source library for pulling structured data out of large language models. In Python you describe the result you want as a Pydantic model, pass it as a response_model, and Instructor converts it to a schema the model understands, checks the reply against your rules and retries with the error when validation fails. A single from_provider call creates a client for OpenAI, Anthropic, Google, Mistral, Cohere, Ollama, DeepSeek and more than 15 other providers, so switching models does not change your extraction code. It supports streaming of partial objects and lists, nested schemas, custom validators, hooks, caching and token-usage tracking. Ports exist for TypeScript, Go, Ruby, Elixir and Rust. The project says Instructor is meant for quick schema-first extraction and points to PydanticAI when you need agents with tools and dashboards. Instructor itself has no pricing plans, since you only pay your model provider.

Use cases

• Extract structured data from text
• Validate LLM responses against a schema
• Classify content with typed outputs
• Parse documents and PDFs into models
• Stream partial structured results
• Switch LLM providers without code changes

Who it's for

• Python developers
• Data engineers
• AI engineers

Why use Instructor

• Typed results cut the amount of hand-written JSON parsing and error handling in your code.
• Validation plus retries catches malformed model answers before they reach the rest of your application.
• A shared interface across providers makes it simple to compare or swap models.
• Familiar Pydantic syntax means little new to learn for Python teams.

Instructor features

• Pydantic response models for structured output
• Automatic retries when validation fails
• Custom validators and Pydantic field rules
• Streaming of partial objects and iterable lists
• One from_provider interface for 15+ providers
• Local models through Ollama, llama-cpp-python or vLLM
• Multimodal input including audio, images and PDFs
• Hooks for monitoring and debugging
• Response caching and token usage tracking
• FastAPI integration
• Access to the raw LLM completion

Instructor integrations

• OpenAI
• Anthropic
• Google Gemini
• Mistral
• Cohere
• Ollama
• DeepSeek
• Groq
• LiteLLM
• OpenRouter
• AWS Bedrock
• FastAPI

How to get started with Instructor

1. Install Instructor with pip, uv or poetry, adding the extra for your provider if needed.
2. Define a Pydantic model describing the fields you want back.
3. Create a client with from_provider, for example for OpenAI, Anthropic or a local Ollama model.
4. Call create with your messages and the response model.
5. Use the validated, typed object, or stream partial results as they arrive.

Instructor limitations

• It is a code library, so using it requires programming
• You pay your LLM provider for model calls separately
• Each provider supports different modes and capabilities
• For agents with quality gates and dashboards the docs point to PydanticAI

Instructor pricing

Instructor is open source, so you can use and self-host it for free.

Prices can change and may vary by country or exclude tax. Check the official pricing page.

Instructor alternatives

The main Instructor alternatives listed on Debuly are Pydantic AI, LangChain, Outlines, Marvin, Guidance and BAML. The table compares pricing and platforms; order is A–Z.

1. 

   BAML

   Open-source, TypeScript-like programming language for agents, with typed LLM functions, built-in tests and SDK generation.

   Developer platformsCoding
   Open sourceVisit BAML (official site)
2. 

   Guidance

   Python library for steering language models, combining constrained generation with ordinary control flow so outputs follow regexes, grammars or JSON schemas.

   Developer platforms
   Open sourceVisit Guidance (official site)
3. 

   LangChain

   Open-source framework for building LLM agents, paired with LangSmith for tracing, evals and agent deployment.

   Developer platformsAutomation and agentsCoding
   FreemiumVisit LangChain (official site)
4. 

   Marvin

   Open source Python framework from Prefect for getting structured output from LLMs and building agent workflows from tasks and threads.

   Developer platformsCodingAutomation and agents
   Open sourceVisit Marvin (official site)
5. 

   Outlines

   Python library from .txt that makes LLM output match a type you define, such as a Pydantic model, enum or regex, during generation.

   Developer platformsCodingAutomation and agents
   Open sourceVisit Outlines (official site)
6. 

   Pydantic AI

   A type-safe, model-agnostic Python framework for building agents and LLM applications, from the team behind Pydantic.

   Developer platformsAutomation and agentsCoding
   Open sourceVisit Pydantic AI (official site)

Instructor FAQ

Sources & verification

Facts on this page come from the official sources below, each with the date we read it. Written by Debuly; the vendor did not review this page.

Image credits

• Logo: from python.useinstructor.com · fetched 23 Oct 2026 · Vendor trademark, used only to identify the product; removed on request
• Cover: none collected yet, so a generated tile is shown.

Spot an error? Report an issue with this listing. We also remove a logo or image on the owner's request.