Repolode
pgvector

pgvector/pgvector-node

Node.js, Deno, Bun의 데이터베이스 클라이언트와 ORM에서 pgvector 벡터 타입을 지원하는 JavaScript 및 TypeScript 헬퍼 라이브러리입니다.

스타
445
포크
24
열린 이슈
2
마지막 커밋
어제

어떤 프로젝트인가요?

pgvector-node는 JavaScript 및 TypeScript 애플리케이션에서 pgvector 확장을 통해 PostgreSQL에 벡터 임베딩을 저장하고, 삽입하고, 조회할 수 있게 해 주는 작은 라이브러리입니다. JavaScript 배열을 pgvector의 텍스트 형식으로 변환하고 데이터베이스 드라이버에 벡터 타입을 등록하므로, 개발자는 일반 숫자 배열을 그대로 사용할 수 있습니다.

이 패키지는 node-postgres, Knex.js, Kysely, Sequelize, Prisma, Drizzle ORM, TypeORM, MikroORM, Postgres.js, Slonik, deno-postgres, Bun SQL을 비롯한 다양한 데이터베이스 접근 계층을 지원합니다. 각 통합에는 확장 활성화, 벡터 컬럼 생성, 데이터 삽입, L2·내적·코사인 거리를 이용한 최근접 이웃 쿼리 실행, HNSW 또는 IVFFlat 인덱스 추가를 위한 별도의 설정 단계가 있습니다.

저장소에는 희소 벡터를 위한 SparseVector 클래스와 OpenAI 및 Cohere 임베딩, Transformers.js, 하이브리드 검색, COPY를 이용한 대량 로딩 등 흔히 쓰이는 임베딩 워크플로의 예제 프로젝트도 포함되어 있습니다.

핵심 기능

  • 01JavaScript 배열을 pgvector 형식으로 변환하고 드라이버에 벡터 타입을 등록합니다.
  • 02Node.js, Deno, Bun용 데이터베이스 라이브러리와 ORM을 12종 이상 지원합니다.
  • 03여러 통합에서 L2, 내적, 코사인, L1, 해밍, 자카드 거리 계산 헬퍼를 제공합니다.
  • 04HNSW 및 IVFFlat 인덱스 생성 예제를 포함합니다.
  • 05희소 벡터 데이터를 위한 SparseVector 클래스를 제공합니다.

활용 사례

  • PostgreSQL을 사용하는 Node.js 앱에 시맨틱 검색 또는 검색·검색 증강 기능을 구축합니다.
  • 기존 ORM을 사용해 OpenAI 또는 Cohere 임베딩을 관계형 데이터와 함께 저장합니다.
  • Deno 또는 Bun 서비스에서 벡터 유사도 쿼리를 실행합니다.

빠른 시작

  1. 1

    npm에서 pgvector 패키지를 설치합니다

    npm install pgvector
  2. 2

    데이터베이스에서 pgvector 확장 기능을 활성화합니다

    await client.query('CREATE EXTENSION IF NOT EXISTS vector');
  3. 3

    node-postgres 클라이언트에 vector 타입을 등록합니다

    await pgvector.registerTypes(client);

사용 전 알아둘 점

  • PostgreSQL 서버에 pgvector 확장 기능이 설치되어 있어야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

pgvector-node은(는) 무엇인가요?
Node.js, Deno, Bun의 데이터베이스 클라이언트와 ORM에서 pgvector 벡터 타입을 지원하는 JavaScript 및 TypeScript 헬퍼 라이브러리입니다. pgvector-node는 JavaScript 및 TypeScript 애플리케이션에서 pgvector 확장을 통해 PostgreSQL에 벡터 임베딩을 저장하고, 삽입하고, 조회할 수 있게 해 주는 작은 라이브러리입니다. JavaScript 배열을 pgvector의 텍스트 형식으로 변환하고 데이터베이스 드라이버에 벡터 타입을 등록하므로, 개발자는 일반 숫자 배열을 그대로 사용할 수 있습니다.
pgvector-node은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pgvector-node은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
pgvector-node은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pgvector-node의 마지막 커밋은 2026년 11월 5일입니다.
pgvector-node은(는) 어디에 사용할 수 있나요?
PostgreSQL을 사용하는 Node.js 앱에 시맨틱 검색 또는 검색·검색 증강 기능을 구축합니다. 기존 ORM을 사용해 OpenAI 또는 Cohere 임베딩을 관계형 데이터와 함께 저장합니다. Deno 또는 Bun 서비스에서 벡터 유사도 쿼리를 실행합니다.
pgvector-node는 어떻게 설치하나요?
npm에서 pgvector 패키지를 설치합니다: npm install pgvector 데이터베이스에서 pgvector 확장 기능을 활성화합니다: await client.query('CREATE EXTENSION IF NOT EXISTS vector'); node-postgres 클라이언트에 vector 타입을 등록합니다: await pgvector.registerTypes(client);
pgvector-node은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pgvector/pgvector-node

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

관련 프로젝트