whatisgithub

What is pgvec-studio?

rishabhguptajs/pgvec-studio — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5LicenseSetup · moderate

In one sentence

A local tool that turns pgvector embeddings into an interactive 2D scatter plot so you can see and search your vector data visually.

Mindmap

mindmap
  root((pgvec-studio))
    What it does
      Visualizes embeddings
      2D scatter plot
      Runs locally
    Tech stack
      Next.js
      TypeScript
      umap-js
    Use cases
      Debug retrieval
      Spot check quality
      Explore neighbors
    Audience
      Developers
      Data teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Visualize embeddings stored in a pgvector table as a 2D scatter plot to spot clusters.

USE CASE 2

Search for the nearest neighbors of a specific vector to debug retrieval quality.

USE CASE 3

Filter large embedding tables by metadata before visualizing to avoid overload.

USE CASE 4

Export a filtered set of embeddings and metadata as CSV or JSON.

What is it built with?

Next.jsTypeScriptTailwind CSSnode-postgresumap-jsPlotly.jsPostgreSQLpgvector

How does it compare?

rishabhguptajs/pgvec-studio0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing PostgreSQL database with the pgvector extension and at least one vector column.

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

pgvec-studio is a tool for looking at the vector embeddings stored in a PostgreSQL database that uses the pgvector extension. Embeddings are long lists of numbers that represent things like text or images in a way a computer can compare, and normally there is no easy way to see what they actually look like. This project gives you a visual way to explore them. You paste in a database connection string, choose a table that has a vector column, and click a button to visualize it. The tool takes the high dimensional numbers and squishes them down into a 2D scatter plot using a technique called UMAP, which tries to keep similar items close together on the chart. That means embeddings that represent similar content will cluster near each other, so you can actually see patterns in your data instead of guessing. Beyond the chart, you can click on any point to see its metadata, search for the nearest neighbors of a specific vector, filter rows before visualizing so you are not overwhelmed by millions of points, and compare two rows directly to get a cosine similarity score. There is also an export option so you can save the filtered data as CSV or JSON for use elsewhere. Everything runs on your own computer through a local Next.js server. Nothing is uploaded anywhere, there is no account to create, and your connection string only lives for the length of your browser session. The app only reads from your database, so a read-only database user works fine. To use it, you need PostgreSQL with the pgvector extension already set up and at least one table with a vector column, plus Node.js version 18 or newer installed on your machine. Setup is a standard clone, install, and run sequence. The project is built with Next.js, TypeScript, and Tailwind CSS, with node-postgres handling the database connection and umap-js doing the dimensionality reduction in JavaScript. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up pgvec-studio to connect to my Supabase Postgres database with pgvector.
Prompt 2
Explain how UMAP projects my embeddings into 2D and what pgvec-studio's scatter plot is showing me.
Prompt 3
Show me how to use pgvec-studio's cosine similarity calculator to compare two rows in my table.
Prompt 4
Walk me through filtering my embeddings table by metadata before visualizing it in pgvec-studio.

Frequently asked questions

What is pgvec-studio?

A local tool that turns pgvector embeddings into an interactive 2D scatter plot so you can see and search your vector data visually.

What language is pgvec-studio written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, Tailwind CSS.

What license does pgvec-studio use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pgvec-studio to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pgvec-studio for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.