Repolode
pgvector

pgvector/pgvector-node

Node.js、Deno、BunのデータベースクライアントやORMでpgvectorのベクトル型を使えるようにする、JavaScript・TypeScript向けヘルパーライブラリです。

スター
445
フォーク
24
未解決の Issue
2
最終コミット
3 日前

これは何?

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向けの12を超えるデータベースライブラリやORMに対応しています。
  • 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 の数値は毎日更新されます。

関連プロジェクト