hollowdb vector Download - hollowdb vector Source Source Download

hollowdb vector

ซอร์สโค้ดอื่น ๆ

v0.1.4

ดาวน์โหลด

เวกเตอร์ HollowDB

การดำเนินการตามดัชนี Small Worlds (HNSW) ตามลำดับชั้นเหนือ HollowDB

การติดตั้ง

ติดตั้งแพ็คเกจ:

yarn add hollowdb-vector
pnpm add hollowdb-vector
npm install hollowdb-vector

การใช้งาน

คุณสามารถสร้าง vectordb ดังนี้:

 import HollowDBVector from "hollowdb-vector" ;
import { WarpFactory , defaultCacheOptions } from "warp-contracts" ;
import { SetSDK } from "hollowdb" ;
import { Redis } from "ioredis" ;
import { RedisCache } from "warp-contracts-redis" ;

// connect to Redis
const redis = new Redis ( ) ;

// create Warp instance with Redis cache
const warp = WarpFactory . forMainnet ( ) . useKVStorageFactory (
  ( contractTxId : string ) =>
    new RedisCache ( { ... defaultCacheOptions , dbLocation : ` ${ contractTxId } ` } , { client : redis } ) ,
) ;

// create HollowDB SDK
const wallet = JSON . parse ( readFileSync ( "./path/to/wallet.json" , "utf-8" ) ) ;
const contractTxId = "your-contract-tx-id" ;
const hollowdb = new SetSDK < string > ( wallet , contractTxId , warp ) ;

// create HollowDB Vector
const vectordb = new HollowDBVector ( hollowdb ) ;

การแทรกเวกเตอร์

ด้วยสิ่งนี้คุณสามารถแทรกจุดใหม่:

 const point = [ - 0.28571999073028564 /* and many more... */ , 0.13964000344276428 ] ;

// any object
const metadata = {
  name : "My favorite vector!" ,
} ;

// insert a point
await vectordb . insert ( point , metadata ) ;

ข้อมูลเมตาเป็นตัวเลือกและคุณสามารถทิ้งไว้ในระหว่าง insert หากคุณต้องการตั้งค่าในภายหลังคุณสามารถทำได้:

 vectordb . db . set_metadata ( index , metadata ) ;

บันทึก

ความซับซ้อนของการแทรกจุดอาจเพิ่มขึ้นด้วยคะแนนมากขึ้นใน DB

ดึงเวกเตอร์

คุณสามารถรับเวกเตอร์จากดัชนีซึ่งส่งคืนค่าจุดและข้อมูลเมตา:

 const { point , metadata } = await vectordb . get_vector ( index ) ;

การสอบถามเวกเตอร์

คุณสามารถทำการสืบค้นและส่งคืนผลลัพธ์ที่เกี่ยวข้อง K ด้านบน:

 // a query point
const query = [ - 0.28571999073028564 /* and many more... */ , 0.13964000344276428 ] ;

// number of top results to return
const K = 10 ;

// make a KNN search
const results = await vectordb . knn_search ( query , K ) ;

// each result contains the vector id, its distance to query, and metadata
const { id , distance , metadata } = results [ 0 ] ;

ปรับใช้สัญญาของคุณเอง

HollowDB Vector ส่งออกฟังก์ชั่นคงที่ที่ช่วยให้คุณปรับใช้สัญญาใหม่ที่คุณเป็นเจ้าของสองคน สมมติว่าคุณมี wallet และอินสแตนซ์วา warp ตามที่อธิบายไว้ข้างต้นคุณสามารถสร้างสัญญาใหม่ด้วย:

 const { contractTxId } = await HollowDBVector . deploy ( wallet , warp ) ;
console . log ( "Deployed at:" , contractTxId ) ;

การตั้งค่า

สำหรับการตั้งค่าท้องถิ่นของ repo นี้ให้ทำการโคลนครั้งแรก

git clone https://github.com/firstbatchxyz/hollowdb-vector

จากนั้นติดตั้งแพ็คเกจ:

pnpm install

ควรติดตั้งการพึ่งพาของเพียร์โดยอัตโนมัติ

ผู้มีอำนาจ

เรารวม protobuf ที่รวบรวมไว้ล่วงหน้าภายใน repo แต่ถ้าคุณจะเปลี่ยน protobuf ในภายหลังคุณสามารถสร้างรหัสที่รวบรวมได้ดังนี้:

 # HNSW protobufs
pnpm proto:code:hnsw # generate js code
pnpm proto:type:hnsw # generate types

# Request protobufs
pnpm proto:code:req # generate js code
pnpm proto:type:req # generate types