instructor

Instructor é uma biblioteca Python projetada para simplificar a extração de dados estruturados a partir de modelos de linguagem grandes (LLMs). Ela se integra ao Pydantic para fornecer saídas validadas e com tipagem segura, sem necessidade de análise manual de JSON ou tratamento de erros. Os desenvolvedores definem um modelo Pydantic representando a estrutura desejada da saída e o passam à interface do cliente do Instructor, que automaticamente lida com a geração do esquema, validação da resposta e lógica de novas tentativas caso a validação falhe. A biblioteca suporta múltiplos provedores de LLM, incluindo OpenAI, Anthropic, Google Gemini, Ollama e Groq — todos por meio de uma API consistente. Também oferece recursos avançados, como streaming de resultados parciais durante a geração, extração de objetos aninhados e novas tentativas automáticas com feedback para saídas inválidas. O Instructor é leve comparado a frameworks como LangChain ou LlamaIndex, focando exclusivamente na extração estruturada. É usado em produção por mais de 100.000 desenvolvedores e empresas, incluindo equipes da OpenAI, Google, Microsoft e AWS. O projeto tem mais de 10K estrelas no GitHub e mais de 3 milhões de downloads mensais. Além do Python, o Instructor oferece implementações oficiais em TypeScript, Ruby, Go, Elixir e Rust. Documentação, exemplos e suporte da comunidade estão disponíveis pelo site e pelo servidor do Discord. Para fluxos de trabalho de agentes mais complexos, a equipe recomenda o PydanticAI, que se constrói sobre a base do Instructor com funcionalidades adicionais de ferramentas e observabilidade. A instalação é simples via pip, uv ou Poetry. Sem configuração complexa — basta definir seu modelo e extrair dados estruturados de forma confiável a partir de entradas em linguagem natural.