whatisgithub

What is embedding-atlas?

apple/embedding-atlas — explained in plain English

Analysis updated 2026-06-26

4,776TypeScriptAudience · dataComplexity · 3/5LicenseSetup · moderate

In one sentence

Embedding Atlas is an interactive visualization tool for exploring millions of AI-produced data points (embeddings) on a map-like canvas, with automatic clustering, search, and metadata filtering. Available as a Python CLI, Jupyter widget, and JavaScript package.

Mindmap

mindmap
  root((embedding-atlas))
    What It Does
      Visualize embeddings
      Auto-cluster data
      Search similar points
      Filter by metadata
    Tech Stack
      TypeScript
      Python
      WebGPU and WebGL
      React and Svelte
    Use Cases
      Explore AI datasets
      Jupyter notebooks
      Web app integration
    Audience
      Data scientists
      ML practitioners
      Developers
Click or tap to explore — scroll the page freely

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 millions of text or image embeddings on an interactive map with automatic cluster labels.

USE CASE 2

Build a Jupyter notebook that lets you inspect and filter AI dataset clusters interactively.

USE CASE 3

Integrate embedding visualization into a React or Svelte web app using the JavaScript package.

USE CASE 4

Find data points similar to a search query within a large embedding dataset.

What is it built with?

TypeScriptPythonWebGPUWebGLJupyterReactSvelteParquet

How does it compare?

apple/embedding-atlaschanind/hanzi-writerheilcheng/awesome-agent-skills
Stars4,7764,7684,765
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencedatadevelopervibe coder

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python with the embedding-atlas package installed and a Parquet-format data file, WebGPU-capable browser recommended for best performance.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice (MIT License).

So what is it?

Embedding Atlas is an interactive visualization tool from Apple for exploring large collections of data points that have been converted into numerical representations called embeddings. Embeddings are commonly produced by AI models when processing text, images, or other content, and they capture meaning in a form that computers can compare. Embedding Atlas lets you see those points laid out visually on a map-like canvas, with up to a few million points rendered smoothly. The tool automatically groups similar points into clusters and labels them, so you can see the overall shape of a dataset without having to inspect individual items. You can also search for points similar to a query, filter points by metadata columns linked to the main view, and see density contours that highlight where data is concentrated versus sparse. Embedding Atlas is available in three forms. The Python command-line tool takes a data file in Parquet format and opens an interactive viewer with a single command. A Python widget lets you embed the same viewer inside a Jupyter notebook, passing a data frame directly. A JavaScript package lets developers integrate the visualization into web applications, with support for React and Svelte. The tool is backed by a research paper and is aimed at data scientists, machine learning practitioners, and developers who want to inspect or communicate patterns in large AI datasets. It requires Python or a modern JavaScript environment to use. The rendering is done with WebGPU where available, falling back to WebGL 2 on older browsers, which keeps the interface fast even with large datasets. The code is open source under the MIT license.

Copy-paste prompts

Prompt 1
Using Apple Embedding Atlas Python CLI, load my embeddings.parquet file and open the interactive viewer, show me the exact command and any options I should know.
Prompt 2
Write a Jupyter notebook cell that loads a pandas DataFrame of text embeddings into the Embedding Atlas widget and enables metadata column filtering.
Prompt 3
Show me how to add the Embedding Atlas JavaScript package to a React app and render a scatter map of 500k embeddings with density contours.
Prompt 4
How do I use Embedding Atlas to search for the 20 nearest neighbors to a query string in my dataset and highlight them on the canvas?
Prompt 5
What does Embedding Atlas need to run in an older browser that does not support WebGPU, and does it fall back automatically?

Frequently asked questions

What is embedding-atlas?

Embedding Atlas is an interactive visualization tool for exploring millions of AI-produced data points (embeddings) on a map-like canvas, with automatic clustering, search, and metadata filtering. Available as a Python CLI, Jupyter widget, and JavaScript package.

What language is embedding-atlas written in?

Mainly TypeScript. The stack also includes TypeScript, Python, WebGPU.

What license does embedding-atlas use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice (MIT License).

How hard is embedding-atlas to set up?

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

Who is embedding-atlas for?

Mainly data.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.