pinecone-io/python-sdk

Pinecone Python SDK – 빠른 개요

무엇인가요: Pinecone의 관리형 벡터 데이터베이스 서비스용 Python 클라이언트 라이브러리입니다. 인덱스 생성, 벡터 임베딩된 문서 저장(업서트), Python 코드에서 직접 유사성 검색을 수행할 수 있습니다.

주요 기능

• 인덱스 관리 – pc.indexes.create를 통해 인덱스 생성, 구성, 삭제 가능.
• 문서 기반 API – 각 레코드를 _id, 밀집 벡터 필드, 스키마에서 정의한 사용자 정의 메타데이터를 가진 JSON 문서로 취급.
• 유사성 검색 – DenseVectorQuery로 코사인 거리 등 다양한 메트릭을 사용해 가장 유사한 항목(top-k)을 검색.
• 비동기 지원 – asyncio와 호환되는 AsyncPinecone 클라이언트로 비차단 워크로드 처리 가능.
• 구성 – 간편한 API 키 처리, 사용자 정의 호스트, 타임아웃, 디버그 로깅 지원.

일반적인 워크플로우

1. API 키로 클라이언트 초기화.
2. dense_vector 필드를 포함한 스키마를 지정해 인덱스 생성.
3. 네임스페이스에 문서(벡터 + 메타데이터) 업서트.
4. 밀집 벡터 쿼리를 사용해 매칭되는 문서 ID와 점수를 검색.

왜 중요한가: 벡터 데이터베이스는 현대 AI 파이프라인의 핵심 요소로, LLM, 이미지 모델 등에서 생성된 임베딩을 저장하고, 추천, 의미 기반 검색, RAG(검색 기반 생성) 등의 사용 사례에서 빠른 근접 이웃 검색을 가능하게 합니다.

시작하기

pip install pinecone

from pinecone import Pinecone, DenseVectorQuery
pc = Pinecone(api_key="YOUR_KEY")
# README에 나와 있는 대로 인덱스 생성, 업서트, 검색 수행…

개발: 의존성 관리는 uv를 사용하며, 테스트, 타입 체크(mypy), 린팅(ruff), 포맷팅이 내장되어 있습니다. 통합 테스트는 실시간 서비스에 접근하며 API 키가 필요합니다.

라이선스: Apache-2.0.

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔습니다.