Repolode
567-labs

567-labs/instructor

여러 LLM 제공업체에서 Pydantic으로 검증된 구조화 데이터를 가져오고, 검증 실패 시 자동으로 재시도하는 Python 라이브러리입니다.

스타
14,046
포크
1,330
열린 이슈
214
마지막 커밋
어제

어떤 프로젝트인가요?

Instructor는 원하는 출력 형식을 Pydantic 모델로 정의해 LLM 응답에서 타입이 지정된 데이터를 추출합니다. JSON 스키마를 직접 작성하고 원시 텍스트를 파싱하는 대신, 클라이언트에 response_model을 전달하면 검증된 Python 객체를 받을 수 있습니다.

이 라이브러리는 OpenAI, Anthropic, Google, Ollama, Groq 등 여러 제공업체의 API를 from_provider로 만든 단일 인터페이스로 감쌉니다. 검증에 실패하면 Instructor는 오류 메시지를 모델에 다시 전달해 설정 가능한 max_retries 횟수까지 재시도합니다. 부분 객체 스트리밍과 중첩 모델도 지원합니다.

프로젝트 문서에는 Python 외에도 TypeScript, Ruby, Go, Elixir, Rust 구현이 소개되어 있습니다.

핵심 기능

  • 01Pydantic 모델로 출력 스키마를 정의하고 검증된 객체를 반환합니다.
  • 02하나의 from_provider 인터페이스로 여러 LLM 제공업체를 사용할 수 있습니다.
  • 03검증에 실패하면 오류를 모델에 전달해 자동으로 재시도합니다.
  • 04생성되는 부분 객체를 스트리밍합니다.
  • 05중첩 모델과 모델 목록을 지원합니다.

활용 사례

  • 자유 형식 텍스트에서 이름, 날짜, 가격 등의 필드를 추출합니다.
  • LLM 출력을 후속 애플리케이션 코드에서 사용할 타입 지정 데이터로 변환합니다.
  • 직접 파싱하지 않고 모델에서 신뢰할 수 있는 JSON을 받아야 하는 파이프라인을 구축합니다.

빠른 시작

  1. 1

    pip으로 라이브러리를 설치합니다

    pip install instructor
  2. 2

    사용할 프로바이더의 클라이언트를 만들고 Pydantic 모델을 추출합니다

사용 전 알아둘 점

  • API 키 또는 OpenAI, Anthropic 같은 LLM 프로바이더나 로컬 Ollama 서버가 실행 중이어야 합니다.

토픽

자주 묻는 질문

instructor은(는) 무엇인가요?
여러 LLM 제공업체에서 Pydantic으로 검증된 구조화 데이터를 가져오고, 검증 실패 시 자동으로 재시도하는 Python 라이브러리입니다. Instructor는 원하는 출력 형식을 Pydantic 모델로 정의해 LLM 응답에서 타입이 지정된 데이터를 추출합니다. JSON 스키마를 직접 작성하고 원시 텍스트를 파싱하는 대신, 클라이언트에 response_model을 전달하면 검증된 Python 객체를 받을 수 있습니다.
instructor은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
instructor은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
instructor은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. instructor의 마지막 커밋은 2026년 10월 20일입니다.
instructor은(는) 어디에 사용할 수 있나요?
자유 형식 텍스트에서 이름, 날짜, 가격 등의 필드를 추출합니다. LLM 출력을 후속 애플리케이션 코드에서 사용할 타입 지정 데이터로 변환합니다. 직접 파싱하지 않고 모델에서 신뢰할 수 있는 JSON을 받아야 하는 파이프라인을 구축합니다.
instructor는 어떻게 설치하나요?
pip으로 라이브러리를 설치합니다: pip install instructor 사용할 프로바이더의 클라이언트를 만들고 Pydantic 모델을 추출합니다
instructor은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/567-labs/instructor

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트