instructor

Instructorは、大規模言語モデル（LLM）から構造化データを抽出することを目的としたPythonライブラリです。Pydanticとの統合により、手動のJSONパーシングやエラーハンドリングなしで型安全かつ検証済みの出力を提供します。 開発者は抽出したい出力構造を表すPydanticモデルを定義し、それをInstructorのクライアントインターフェースに渡すだけでよく、スキーマ生成、レスポンス検証、失敗時のリトライロジックが自動で行われます。 OpenAI、Anthropic、Google Gemini、Ollama、Groqなど複数のLLMプロバイダに対応しており、一貫したAPIを通じて利用できます。他にも、生成中の部分的ストリーミング結果やネストされたオブジェクトの抽出、不正な出力に対するフィードバック付き自動リトライなどの高度な機能も提供しています。 LangChainやLlamaIndexなどのフレームワークと比べて軽量で、構造化抽出に特化しています。OpenAI、Google、Microsoft、AWSのチームを含む10万人以上の開発者や企業にプロダクション環境で使用されており、GitHubでのスター数は10K以上、月間ダウンロード数は300万以上を記録しています。 Python以外にもTypeScript、Ruby、Go、Elixir、Rust向けの公式実装を提供しています。ドキュメント、例、コミュニティサポートはウェブサイトやDiscordサーバーで利用可能です。より複雑なエージェントワークフローについては、Instructorの基盤の上に追加ツールと観測機能を備えたPydanticAIの使用を推奨しています。 インストールはpip、uv、またはPoetry経由で手軽に可能です。複雑なセットアップは不要で、モデルを定義するだけで自然言語入力から構造化データの抽出が可能になります。