Skip to content

connerkward/Muser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Embedding Visualization

Interactive visualization of image and text embeddings using CLIP and sentence-transformers, rendered as a topographical map and network graph.

Demo

Features

Dual Mode Visualization

Toggle between Image (IMG) and Text (TXT) modes to visualize different embedding types:

Image Mode: Visualizes image embeddings from CLIP model, showing semantic clusters of similar images with labeled categories like:

  • FURNITURE / PRODUCT PHOTO
  • SCREENSHOT / ILLUSTRATION
  • UI DESIGN / POSTER
  • PRODUCT PHOTO / TECHNOLOGY
  • PRODUCT PHOTO / FASHION
  • MILITARY / VEHICLE
  • VEHICLE / CAR

Main Text View

Text Mode: Visualizes text embeddings from sentence-transformers, clustering related concepts such as:

  • PHILOSOPHY
  • CHORDS
  • APPLE
  • WALL
  • WOOD
  • SOIL

Topographical Map View

The main view renders embeddings as a topographic map with:

  • Colored clusters: Semi-transparent nodes grouped by similarity
  • Contour lines: Light blue elevation lines showing embedding density
  • Cluster labels: White text labels identifying semantic categories
  • Color coding: Different colors represent distinct clusters or categories

Detailed Cluster Views

Clicking on clusters reveals detailed views:

Image Detail View

Image Detail: Shows actual product images connected by curved lines, indicating similarity relationships. Features:

  • Thumbnail grid of related images
  • Connection lines showing proximity in embedding space
  • Category focus (e.g., "PRODUCT PHOTO / FASHION")

Text Detail View

Text Detail: Displays interconnected text nodes in a network graph:

  • Rectangular nodes containing document titles and metadata
  • Teal connection lines showing semantic relationships
  • Creation/update timestamps
  • Text previews and excerpts
  • Pink-highlighted nodes indicating selected items

Architecture

See embedding-viz/DECISIONS.md for technical details.

Setup

Frontend

cd embedding-viz/frontend
npm install
npm run dev

Visit http://localhost:3000

Pipeline

cd embedding-viz/pipeline
uv run python main.py --input /path/to/images --mode image

Usage

  1. Generate embeddings using the pipeline
  2. Place JSON output in embedding-viz/frontend/public/data/
  3. Open the app in browser
  4. Toggle between IMG/TXT modes
  5. Click clusters to explore detailed views

About

Topographical embedding map of your images and text files

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published