{
 "kind": "tool",
 "slug": "instructor",
 "path": "tools/instructor/",
 "name": "Instructor",
 "maker": null,
 "density": "basic",
 "crumbs": [
  [
   "Tools",
   "tools/"
  ],
  [
   "Prompts, structured output and evals",
   "tools/llm-tooling/"
  ]
 ],
 "lead": "Python library to get structured outputs from language models with validation and parsing.",
 "chips": [
  {
   "label": "Prompts, structured output and evals",
   "path": "tools/llm-tooling/"
  },
  {
   "label": "PYPI"
  }
 ],
 "primary": {
  "label": "Copy install command",
  "copy": "pip install instructor"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/567-labs/instructor"
  }
 ],
 "track": "New versions, deprecation and license changes on your dashboard",
 "verdicts": [
  {
   "key": "license",
   "label": "License",
   "value": "MIT",
   "status": "yes",
   "sub": "Use it in paid apps",
   "quote": null,
   "note": "License from PyPI license field.",
   "src": "https://github.com/567-labs/instructor"
  },
  {
   "key": "maint",
   "label": "Maintained",
   "value": "Maintained",
   "status": "yes",
   "sub": "Last change Nov 16, 2026",
   "note": "Latest GitHub release Sep 9, 2026. ",
   "src": "https://github.com/567-labs/instructor"
  },
  {
   "key": "pop",
   "label": "Used by agents' projects",
   "value": "4 projects",
   "status": "info",
   "sub": "#24 of 78 in its category",
   "note": "Dependency in 4 public GitHub projects set up for AI coding agents that we scanned (0.1%).",
   "src": null
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Community skills",
   "status": "info",
   "sub": "1 skills by others",
   "note": "Agent skills for this library in the skills catalog; community skills are written by others, read them before you install.",
   "src": null
  }
 ],
 "vfoot": "From the package registry and GitHub, checked daily.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Instructor does",
   "parts": [
    {
     "t": "prose",
     "text": "Python library to get structured outputs from language models with validation and parsing."
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Instructor popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "62",
       "of": "/ 100",
       "l": "Gid Score, #792 overall"
      },
      {
       "n": "2.5M",
       "l": "downloads a week, pypi"
      },
      {
       "n": "14.1K",
       "l": "GitHub stars"
      },
      {
       "n": "4",
       "l": "agent projects use it"
      }
     ]
    },
    {
     "t": "small",
     "text": "Gid Score measures public popularity and activity, not quality.",
     "link": "How the Gid Score is calculated",
     "path": "tools/top/"
    }
   ]
  },
  {
   "id": "usage",
   "nav": "How it is used",
   "h2": "How Instructor is used",
   "parts": [
    {
     "t": "list",
     "items": [
      "Instructor is a dependency in 4 of the 6,254 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 3,063, Ethereum and EVM 1,777, 3D and games 3,120, agent frameworks and SDKs 13,629); counting those, it appears in 172 projects, and what it is used with below comes from all of them.",
      "The most used alternative in our scan is DSPy (6 projects).",
      "Projects that use it most often also use Pydantic (90.7%), OpenAI Python Library (90.1%), NumPy (87.8%)."
     ]
    },
    {
     "t": "h3",
     "text": "Often used with"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In 90.7% of its projects",
       "v": "Pydantic",
       "path": "tools/pydantic/"
      },
      {
       "l": "In 90.1% of its projects",
       "v": "OpenAI Python Library",
       "path": "tools/openai-pypi/"
      },
      {
       "l": "In 87.8% of its projects",
       "v": "NumPy",
       "path": "tools/numpy/"
      },
      {
       "l": "In 87.2% of its projects",
       "v": "python-dotenv",
       "path": "tools/python-dotenv/"
      },
      {
       "l": "In 83.1% of its projects",
       "v": "Requests",
       "path": "tools/requests-py/"
      },
      {
       "l": "In 82.0% of its projects",
       "v": "aiohttp",
       "path": "tools/aiohttp/"
      },
      {
       "l": "In 80.2% of its projects",
       "v": "Hugging Face Hub",
       "path": "tools/huggingface-hub/"
      },
      {
       "l": "In 77.9% of its projects",
       "v": "FastAPI",
       "path": "tools/fastapi/"
      }
     ]
    }
   ]
  },
  {
   "id": "more",
   "nav": null,
   "spy_as": "usage",
   "h2": "More about Instructor",
   "parts": [
    {
     "t": "more",
     "items": [
      {
       "title": "Funding",
       "path": "tools/funding/",
       "items": [
        "GitHub Sponsors: https://github.com/jxnl",
        "3 GitHub sponsors"
       ]
      },
      {
       "title": "Agent Skills for it",
       "path": "skills/",
       "items": [
        "instructor: Extract structured data from LLM responses with Pydantic validation, retry failed extractions automatically, parse complex JSON with type sa"
       ]
      },
      {
       "title": "More in Prompts, structured output and evals",
       "path": "tools/llm-tooling/",
       "items": [
        {
         "text": "Ultracite",
         "path": "tools/ultracite/"
        },
        {
         "text": "tiktoken (Python)",
         "path": "tools/tiktoken-pypi/"
        },
        {
         "text": "tokenizers",
         "path": "tools/tokenizers/"
        },
        {
         "text": "LangSmith",
         "path": "tools/langsmith-pypi/"
        },
        {
         "text": "GPT Tokenizer",
         "path": "tools/gpt-tokenizer/"
        },
        {
         "text": "Langfuse (Python)",
         "path": "tools/langfuse-pypi/"
        },
        {
         "text": "TokenLens",
         "path": "tools/tokenlens/"
        },
        {
         "text": "@graphql-codegen/typescript-operations",
         "path": "tools/graphql-codegen-typescript-operations/"
        }
       ]
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Instructor",
       "me": true,
       "facts": [
        "MIT",
        "Gid 62",
        "2.5M/wk"
       ]
      },
      {
       "name": "DSPy",
       "why": "Framework for optimizing LLM prompts and pipelines systematically.",
       "path": "tools/dspy/",
       "facts": [
        "MIT",
        "Gid 63",
        "1.5M/wk"
       ]
      }
     ],
     "more": "Compare Instructor with another tool",
     "more_path": "tools/compare/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "install",
     "intro": "Install it.",
     "code": "pip install instructor"
    },
    {
     "t": "gap",
     "text": "No step-by-step start for Instructor yet: we have not written its hand-checked card."
    }
   ]
  }
 ],
 "glance": [
  [
   "Package",
   "pypi instructor"
  ],
  [
   "Category",
   "Prompts, structured output and evals"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "Gid Score",
   "62.1"
  ],
  [
   "Rank in category",
   "#24 of 78"
  ],
  [
   "GitHub",
   "567-labs/instructor"
  ],
  [
   "Last change",
   "Nov 16, 2026"
  ]
 ],
 "good": [],
 "checked_line": "From the package registry, GitHub and our scan of public agent projects; numbers update daily.",
 "logo": "https://agentgid.com/media/avatars/567-labs.png"
}