Reservoirs lab is a lightweight Electron app designed to connect directly to a Postgres database and visualize high-dimensional vector embeddings stored alongside structured data. It allows users to explore their data interactively and see correlations between metadata and semantic similarity of vector embeddings.
- Postgres Integration: Connect directly to your Postgres database via a connection string. 🛠️
- Vector Visualization: Plot and explore high-dimensional vectors interactively (UMAP with cosine metric used for reduction). 📊
- Neighborhood Exploration: Click on a data point to view points by cosine similarity from point (while maintaining clustering). 🔍
- Lightweight and Local: Runs locally on your machine, keeping your data private. 🖥️
- Node.js and npm installed on your machine.
- Clone this repository:
git clone https://github.com/z-gort/reservoirs-lab.git
- Navigate to the project directory:
cd reservoirs-lab - Install dependencies:
npm install
- Start the app:
npm run dev
- Connect to Your Database:
- Enter your Postgres database connection string in the app's connection window.
- Visualize Vectors:
- View an interactive plot of your vector data.
- Explore Neighborhoods:
- Click on a point to view data points by similarity and metadata correlated with semantic similarity to a point.
