Repolode
pinecone-io

pinecone-io/pinecone-ts-client

관리형 벡터 및 전문 검색 데이터베이스 Pinecone의 공식 TypeScript/Node.js SDK입니다.

스타
279
포크
50
열린 이슈
20
마지막 커밋
그저께

어떤 프로젝트인가요?

Pinecone의 공식 TypeScript 및 Node.js 클라이언트입니다. 서버 측 애플리케이션에서 인덱스를 생성하고 관리하며, 문서와 원시 벡터를 저장하고 Pinecone 인덱스에서 전문 검색, 벡터 검색, 메타데이터 필터링 검색을 수행할 수 있습니다.

이 SDK는 세 가지 워크플로를 지원합니다. 전문 검색을 포함한 문서 저장, 자체 벡터를 사용한 upsert 및 쿼리, 그리고 Pinecone이 호스팅 모델을 사용해 문서 텍스트에서 임베딩을 생성하는 통합 임베딩입니다. 임베딩 및 리랭킹 모델을 위한 추론 엔드포인트와 업로드한 파일을 대상으로 채팅 기능을 제공하는 Pinecone Assistant API 클라이언트도 제공합니다.

이 패키지를 사용하려면 Node.js 22 이상과 TypeScript 5.2 이상이 필요합니다. API 키를 직접 사용하므로 서버 측에서만 사용해야 하며, 브라우저 코드에 포함해서는 안 됩니다.

핵심 기능

  • 01필터링을 적용해 여러 필드에 걸쳐 문서를 저장하고 전문 검색 수행
  • 02메타데이터 필터링을 적용해 벡터를 upsert, 쿼리, 가져오기, 업데이트 및 삭제
  • 03서버리스 인덱스를 생성하고 기존 pod 기반 인덱스 관리
  • 04통합 임베딩을 통해 Pinecone의 호스팅 모델로 서버 측에서 임베딩 생성
  • 05임베딩 및 리랭킹 모델을 위한 독립형 추론 API
  • 06메타데이터에 타입을 지정할 수 있는 범용 TypeScript 타입

활용 사례

  • 자체 문서를 대상으로 Node.js 백엔드에 시맨틱 검색 추가
  • 임베딩을 저장하고 쿼리하는 검색 증강 생성(RAG) 파이프라인 구축
  • 하나의 쿼리에서 텍스트 필드의 키워드 검색과 벡터 유사도 검색 결합
  • 벡터 유사도를 기반으로 추천 시스템 구축

빠른 시작

  1. 1

    npm에서 SDK를 설치합니다

    npm install @pinecone-database/pinecone
  2. 2

    TypeScript를 사용하는 Node 프로젝트라면 Node 타입 선언을 설치합니다

    npm install --save-dev @types/node
  3. 3

    PINECONE_API_KEY를 설정하고 README의 전체 텍스트 검색 빠른 시작 코드를 실행합니다

사용 전 알아둘 점

  • 서버 측 전용입니다. 브라우저에서 사용하면 API 키가 노출될 수 있습니다.
  • Pinecone 계정과 API 키, Node.js 22 이상이 필요합니다.

토픽

자주 묻는 질문

pinecone-ts-client은(는) 무엇인가요?
관리형 벡터 및 전문 검색 데이터베이스 Pinecone의 공식 TypeScript/Node.js SDK입니다. Pinecone의 공식 TypeScript 및 Node.js 클라이언트입니다. 서버 측 애플리케이션에서 인덱스를 생성하고 관리하며, 문서와 원시 벡터를 저장하고 Pinecone 인덱스에서 전문 검색, 벡터 검색, 메타데이터 필터링 검색을 수행할 수 있습니다.
pinecone-ts-client은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pinecone-ts-client은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
pinecone-ts-client은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pinecone-ts-client의 마지막 커밋은 2026년 11월 5일입니다.
pinecone-ts-client은(는) 어디에 사용할 수 있나요?
자체 문서를 대상으로 Node.js 백엔드에 시맨틱 검색 추가 임베딩을 저장하고 쿼리하는 검색 증강 생성(RAG) 파이프라인 구축 하나의 쿼리에서 텍스트 필드의 키워드 검색과 벡터 유사도 검색 결합 벡터 유사도를 기반으로 추천 시스템 구축
pinecone-ts-client는 어떻게 설치하나요?
npm에서 SDK를 설치합니다: npm install @pinecone-database/pinecone TypeScript를 사용하는 Node 프로젝트라면 Node 타입 선언을 설치합니다: npm install --save-dev @types/node PINECONE_API_KEY를 설정하고 README의 전체 텍스트 검색 빠른 시작 코드를 실행합니다
pinecone-ts-client은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pinecone-io/pinecone-ts-client

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

관련 프로젝트