rhinojosa/kdbai-samples

Developer samples for the KDB.AI vector database

The example KDB.AI samples provided aim to demonstrate examples of the use of the KDB.AI vector database in a number of scenarios ranging from getting started guides to industry specific use-cases.

KDB.AI Offerings

KDB.AI comes in two offerings:

1. KDB.AI Cloud - For experimenting with smaller generative AI projects with a vector database in our cloud.
2. KDB.AI Server - For evaluating large scale generative AI applications on-premises or on your own cloud provider.

Depending on which you use, there will be different setup steps and connection details required. You can signup at the links above and see the notebooks for connection inctructions.

What is KDB.AI?

KDB.AI is a time-based vector database that allows developers to build scalable, reliable, and real-time applications by providing advanced search, recommendation, and personalization for Generative AI applications. KDB.AI is a key component of full-stack Generative AI applications that use Retrieval Augmented Generation (RAG).

Built by KX, the creators of kdb+, KDB.AI provides users with the ability to combine unstructured vector embedding data with structured time-series datasets to allow for hybrid use-cases which benefit from the rigor of conventional time-series data analytics and the usage patterns provided by vector databases within the Generative AI space.

What does KDB.AI support?

KDB.AI supports the following feature set:

• Multiple index types: Flat, IVF, IVFPQ and HNSW.
• Multiple distance metrics: Euclidean, Inner-Product, Cosine.
• Top-N and metadata filtered retrieval
• Python and REST Interfaces

Sample Breakdown

At this time, the repository contains the following samples:

Getting Started

• Python Quickstart: A quick introduction to the KDB.AI APIs in Python.

Use-Cases

• Document Search: Semantic Search on PDF Documents.
• Image Search: Image Search on Brain MRI Scans.
• Metadata Filtering: Metadata Filtering to increase search speed and accuracy.
• Multimodal RAG ImageBind: Multimodal RAG with images and text.
• Multimodal RAG Unified Text: Multimodal RAG with images descriptions and text.
• Recommendation System: Music Recommendation on Spotify Data.
• Pattern Matching: Pattern Matching on Sensor Data.
• Retreival Augmented Generation with LangChain: Retrieval Augmented Generation (RAG) with LangChain.
• Retreival Augmented Generation Evaluation with LangChain: Retrieval Augmented Generation (RAG) Evaluation with LangChain.
• Sentiment Analysis: Sentiment Analysis on Disneyland Resort Reviews.

What Platforms Does KDB.AI Integrate With?

• ChatGPT Retrieval Plugin: Example showing a question and answer session using a ChatGPT retrieval plugin using KDB.AI Vector Database.
• Langchain: Example showing a question and answer session using a Langchain integration with the KDB.AI Vector Database.

Setup

This section details the setup steps required to run these samples locally on your machine.

Prerequisites

This setup guide assumes the following:

1. You are using a Unix terminal or similar
2. You have python >= 3.8 installed
3. You have pip installed

Install Python Packages

1. Use the requirements.txt file in the repository to install the relevent Python packages needed to run all of the samples:

   pip install -r requirements.txt

Tip

Running out of disk space? By default, pytorch installs both GPU and CPU related packages. This repo does not require a GPU and hence, will only make use of the CPU related packages. By running the below install command, you will only install the CPU related packages and save approximately 1.5GB of disk space. This command is optional and if run, should be run prior to the above install command.

pip install torch --index-url https://download.pytorch.org/whl/cpu

Install English Sentence Tokeniser

1. Open a Python interpreter:

   python3

2. Install the punkt data resouce for the nltk Python package:

   import nltk
   nltk.download("punkt")

3. Exit the Python interpreter:

   exit()

View & Execute The Samples

1. Run a jupter notebook session:

   jupyter notebook --no-browser

   This will load up the jupyter session in the background and display a URL on screen for you.

2. Paste this URL into your browser

   This will bring up the samples for you to interact with.

Dataset Disclaimer

In this repository, we may make available to you certain datasets for use with the Software. You are not obliged to use such datasets (with the Software or otherwise), but any such use is at your own risk. Any datasets that we may make available to you are provided “as is” and without any warranty, including as to their accuracy or completeness. We accept no liability for any use you may make of such datasets.