Instructor is a library for getting typed, validated objects out of language models. You define the shape you want as a Pydantic model; Instructor turns it into a schema, asks the model to fill it (using the provider's function-calling or JSON-mode support), validates the response, and retries automatically when validation fails. It works across many providers and local engines through a common interface. Its niche is developer ergonomics rather than the decoding mechanism. Outlines, XGrammar, and llguidance guarantee validity by constraining the decoder; Instructor instead leans on the model's own structured-output support plus validate-and-retry, which is simpler to adopt and works even against hosted APIs you cannot constrain directly. Guidance is the closest sibling but is built around scripting generation rather than returning a typed object. For open-source AI it lowers the barrier to treating an open model as a typed function in ordinary application code, which is a large part of how open models get wired into real software.
The Stack · Runtime · Open source
Instructor
Library for getting Pydantic-typed structured output from LLMs across many providers, built on function calling and JSON mode with automatic retries.
Sources
- Instructor on GitHub https://github.com/567-labs/instructor
Want a follow-up? Ask the chat about Instructor in context. It will compare to siblings at the same layer and ground every claim in the wiki.
Other projects at the Runtime layer
12 siblings · ordered open first
- vLLM Open source
Dominant open production inference engine; PagedAttention and continuous batching; NVIDIA / AMD / Intel / TPU support.
- SGLang Open source
RadixAttention plus structured generation; from the LMSYS team; gains for shared-prefix and agent workloads.
- llama.cpp Open source
Georgi Gerganov's local-first inference engine; defines the GGUF format; the on-device standard.
- Ollama Open source
Local model runner; Docker-style UX over llama.cpp; the easiest way to run open weights on your machine.
- Text Generation Inference (TGI) Open source
HuggingFace's production inference server; maintenance mode in 2026 as vLLM became the standard.
- MLC-LLM Open source
Cross-platform compilation (TVM-based); the 'LLM in your browser' or 'on your phone' standard.
- Outlines Open source
Structured-output library using finite-state-machine guided decoding to force model output to match a regex, JSON Schema, or grammar.
- XGrammar Open source
Fast grammar-based constrained-decoding engine, used as a structured-output backend by several open serving engines.
- llguidance Open source
Low-level Rust constrained-decoding engine that enforces grammars and JSON Schema at high throughput; powers Guidance.
- Guidance Open source
A programming model for constrained generation that interleaves control flow with model calls and enforces regex, grammars, and JSON Schema.
- LM Format Enforcer Open source
Token-filtering library that enforces a JSON Schema or regex during generation; integrates with Transformers, vLLM, and llama.cpp.
- TensorRT-LLM Source available
NVIDIA's closed-runtime counterpart; fastest on NVIDIA hardware; depends on closed CUDA kernels and the proprietary TensorRT compiler.