Class USearch

constructor

• new USearch(embeddings, args): USearch

• Parameters

  • embeddings: EmbeddingsInterface

  • args: USearchArgs

  Returns USearch

args

docstore

index

• get index(): Index

• Returns Index

• set index(index): void

• Parameters

  • index: Index

  Returns void

addDocuments

• addDocuments(documents): Promise<string[]>

• Method that adds documents to the usearch index. It generates embeddings for the documents and adds them to the index.

  Parameters

  • documents: Document[]

    An array of Document instances to be added to the index.

  Returns Promise<string[]>

  A promise that resolves with an array of document IDs.

addVectors

• addVectors(vectors, documents): Promise<string[]>

• Method that adds vectors to the usearch index. It also updates the mapping between vector IDs and document IDs.

  Parameters

  • vectors: number[][]

    An array of vectors to be added to the index.

  • documents: Document[]

    An array of Document instances corresponding to the vectors.

  Returns Promise<string[]>

  A promise that resolves with an array of document IDs.

save

• save(directory): Promise<void>

• Method that saves the usearch index and the document store to disk.

  Parameters

  • directory: string

    The directory where the index and document store should be saved.

  Returns Promise<void>

  A promise that resolves when the save operation is complete.

similaritySearchVectorWithScore

• similaritySearchVectorWithScore(query, k): Promise<[Document, number][]>

• Method that performs a similarity search in the usearch index. It returns the k most similar documents to a given query vector, along with their similarity scores.

  Parameters

  • query: number[]

    The query vector.

  • k: number

    The number of most similar documents to return.

  Returns Promise<[Document, number][]>

  A promise that resolves with an array of tuples, each containing a Document and its similarity score.

Static fromDocuments

• fromDocuments(docs, embeddings, dbConfig?): Promise<USearch>

• Static method that creates a new USearch instance from a list of documents. It generates embeddings for the documents and adds them to the usearch index.

  Parameters

  • docs: Document[]

    An array of Document instances to be added to the index.

  • embeddings: EmbeddingsInterface

    An instance of Embeddings used to generate embeddings for the documents.

  • Optional dbConfig: {
        docstore?: SynchronousInMemoryDocstore;
    }

    Optional configuration for the document store.

    • Optional docstore?: SynchronousInMemoryDocstore

  Returns Promise<USearch>

  A promise that resolves with a new USearch instance.

Static fromTexts

• fromTexts(texts, metadatas, embeddings, dbConfig?): Promise<USearch>

• Static method that creates a new USearch instance from a list of texts. It generates embeddings for the texts and adds them to the usearch index.

  Parameters

  • texts: string[]

    An array of texts to be added to the index.

  • metadatas: object | object[]

    Metadata associated with the texts.

  • embeddings: EmbeddingsInterface

    An instance of Embeddings used to generate embeddings for the texts.

  • Optional dbConfig: {
        docstore?: SynchronousInMemoryDocstore;
    }

    Optional configuration for the document store.

    • Optional docstore?: SynchronousInMemoryDocstore

  Returns Promise<USearch>

  A promise that resolves with a new USearch instance.