Instructor

 »  AI Agents  »  SDK  »  Instructor  URL Share on

 Repository   12,600  977
Getting reliable, validated structured JSON outputs from any LLM
structured-output pydantic extraction validation multi-provider retry type-safe
TypeSDK
MaturityMature
Status Maintained

Key Features

Single Agent Streaming Async Support Type Safe Structured Output Self-Hosted

Community Feedback

  Strengths

  • Best-in-class structured output
  • Excellent Pydantic integration
  • Simple API
  • Multi-provider support
  • 3M+ monthly downloads
  • Great documentation

  Weaknesses

  • Not a full agent framework
  • Narrow focus on structured outputs
  • Repository moved (confusing)
  • No orchestration/memory/multi-agent

Instructor Details

Organization567 Labs (Jason Liu)
Organization TypeCompany
CategorySDK
SubcategorySingle agent
DeploymentSDK/Framework
Primary LanguagePython
RuntimePython 3.9+
LicenseMIT
Commercial UseUnrestricted
Install Commandpip install instructor
GitHub Stars12,600
GitHub Forks977
Release CadenceWeekly
MaturityMature
Pricing ModelFree
Free TierFully open-source MIT
Self-Hosted FreeYes
Cost Modelfree + LLM costs
Community SizeLarge (12.6k stars, 3M+ downloads)
Community ActivityVery active
Sentiment Very positive
GPU RequiredNo
Research Date2026-03-24
LLM ProvidersOpenAI, Anthropic, Google, Ollama, any provider
API Keys RequiredLLM provider API key

Use Cases

When to Use

Best for: Reliable structured data extraction from LLMs

Avoid when: Need full agent orchestration, memory, or multi-agent

  Back to Agent Directory
Our Social Media →  
Original data from HuggingFace, OpenCompass and various public git repos.
Check out Ag3ntum — our secure, self-hosted AI agent for server management.
Release v20260328a