v0.26.02026-10-15
What's Changed
* docs: lazy-load light/dark images so the hidden one isn't fetched by @Yigtwxx in https://github.com/apple/embedding-atlas/pull/275
* fix(scripts): normalize line endings before matching versions by @PerryLink in https://github.com/apple/embedding-atlas/pull/274
* fix(cache): overwrite existing cache files on Windows by @kwy404 in https://github.com/apple/embedding-atlas/pull/273
* feat: feature description and similar features list by @donghaoren in https://github.com/apple/embedding-atlas/pull/278
* fix(widget): assign default row ids in row order by @Yigtwxx in https://github.com/apple/embedding-atlas/pull/276
* fix: check readonly query for the MCP query tool by @donghaoren in https://github.com/apple/embedding-atlas/pull/279
* chore(deps): bump actions/upload-artifact from 7.0.1 to 7.0.2 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/280
* chore(deps): bump actions/setup-node from 7.0.0 to 7.1.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/281
* chore(deps): bump actions/download-artifact from 8.0.1 to 8.0.2 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/282
* chore: bump version to 0.26.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/283
New Contributors
* @PerryLink made their first contribution in https://github.com/apple/embedding-atlas/pull/274
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.25.0...v0.26.0
v0.25.02026-10-03
What's Changed
* chore(deps): bump astral-sh/setup-uv from 10.0.0 to 10.0.1 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/251
* fix(utils): avoid TypeError for shadowed hasOwnProperty by @darkdi in https://github.com/apple/embedding-atlas/pull/253
* chore(deps): bump actions/deploy-pages from 5.0.0 to 5.0.1 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/254
* fix(projection): detect HEIF/HEIC/AVIF bytes as images by @Yigtwxx in https://github.com/apple/embedding-atlas/pull/257
* chore(deps): bump astral-sh/setup-uv from 10.0.1 to 10.1.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/263
* feat: add per-point graph metrics (degree, k-core, clustering) by @donghaoren in https://github.com/apple/embedding-atlas/pull/261
* feat(viewer): add highlight prop for programmatic point highlighting by @dataelvisliang in https://github.com/apple/embedding-atlas/pull/262
* fix(backend): read .ndjson files as newline-delimited JSON by @kwy404 in https://github.com/apple/embedding-atlas/pull/264
* feat: parallel coordinates view by @donghaoren in https://github.com/apple/embedding-atlas/pull/265
* chore: bump version to 0.25.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/266
Housekeeping: replace repo-level CODEOF_CONDUCT by @apple-ospo[bot] in https://github.com/apple/embedding-atlas/pull/268
* fix(embedding): send the actual image MIME type to litellm embedders by @Yigtwxx in https://github.com/apple/embedding-atlas/pull/259
* fix(utils): detect WebP images from magic bytes by @kwy404 in https://github.com/apple/embedding-atlas/pull/269
* chore(deps): bump astral-sh/setup-uv from 10.1.0 to 10.2.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/270
* fix(viewer): use per-value timezone offset when inferring time formats by @kwy404 in https://github.com/apple/embedding-atlas/pull/267
* fix(projection): detect numpy and polars list columns as vectors by @Yigtwxx in https://github.com/apple/embedding-atlas/pull/271
* fix(cache): hash numpy scalars in cache keys by @Yigtwxx in https://github.com/apple/embedding-atlas/pull/272
New Contributors
* @darkdi made their first contribution in https://github.com/apple/embedding-atlas/pull/253
* @Yigtwxx made their first contribution in https://github.com/apple/embedding-atlas/pull/257
* @dataelvisliang made their first contribution in https://github.com/apple/embedding-atlas/pull/262
* @kwy404 made their first contribution in https://github.com/apple/embedding-atlas/pull/264
* @apple-ospo[bot] made their first contribution in https://github.com/apple/embedding-atlas/pull/268
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.24.0...v0.25.0
v0.24.02026-08-20
What's Changed
* chore(deps): bump pypa/gh-action-pypi-publish from 1.14.0 to 1.14.2 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/242
* chore(deps): bump astral-sh/setup-uv from 9.0.0 to 10.0.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/243
* feat!: drop webgl2 fallback by @domoritz in https://github.com/apple/embedding-atlas/pull/244
* chore: bump version to 0.24.0 and pin hatchling version by @donghaoren in https://github.com/apple/embedding-atlas/pull/245
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.23.0...v0.24.0
v0.23.02026-08-18
What's Changed
* docs: update imagewoof example with pagerank scores by @donghaoren in https://github.com/apple/embedding-atlas/pull/224
* chore(deps): bump astral-sh/setup-uv from 8.2.0 to 8.3.2 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/228
* docs: add umap graph paper by @domoritz in https://github.com/apple/embedding-atlas/pull/227
* chore(deps): bump actions/setup-node from 6.4.0 to 7.0.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/231
* feat: features list component, text highlighting, and multi-table support by @donghaoren in https://github.com/apple/embedding-atlas/pull/230
* chore(deps): bump actions/checkout from 7.0.0 to 7.0.1 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/236
* chore(deps): bump actions/setup-python from 6.3.0 to 7.0.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/235
* chore(deps): bump pypa/gh-action-pypi-publish from 1.14.0 to 1.14.1 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/234
* chore(deps): bump astral-sh/setup-uv from 8.3.2 to 9.0.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/233
* chore(deps): bump pypa/gh-action-pypi-publish from 1.14.1 to 1.14.2 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/238
* fix: CI build error due to not yet allowed action version by @donghaoren in https://github.com/apple/embedding-atlas/pull/239
* fix: detect plain-bytes image columns by @yuvvantalreja in https://github.com/apple/embedding-atlas/pull/240
* chore: bump version to 0.23.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/241
New Contributors
* @yuvvantalreja made their first contribution in https://github.com/apple/embedding-atlas/pull/240
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.22.0...v0.23.0
v0.22.02026-07-07
What's Changed
* docs: correct typos and grammar in READMEs and documentation by @ApurveKaranwal in https://github.com/apple/embedding-atlas/pull/206
* fix: exit -> return in export application codepath by @StEvUgnIn in https://github.com/apple/embedding-atlas/pull/211
* ci: pin GitHub actions versions and enable dependabot by @madrob in https://github.com/apple/embedding-atlas/pull/213
* refactor: change static path resolution method by @StEvUgnIn in https://github.com/apple/embedding-atlas/pull/212
* feat: enable loading Hugging Face datasets from local path by @bduhan in https://github.com/apple/embedding-atlas/pull/207
* feat: support running umap by step by @donghaoren in https://github.com/apple/embedding-atlas/pull/214
* fix: amendment for PR #214 by @donghaoren in https://github.com/apple/embedding-atlas/pull/215
* chore(deps): bump actions/checkout from 6.0.3 to 7.0.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/216
* chore(deps): bump actions/cache from 5.0.5 to 6.1.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/218
* chore(deps): bump actions/setup-python from 6.2.0 to 6.3.0 by @dependabot[bot] in https://github.com/apple/embedding-atlas/pull/219
* fix: use WebGPU on Firefox instead of falling back to WebGL by @domoritz in https://github.com/apple/embedding-atlas/pull/220
* docs: add example with imagewoof dataset by @donghaoren in https://github.com/apple/embedding-atlas/pull/221
* chore: bump version to 0.22.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/223
New Contributors
* @ApurveKaranwal made their first contribution in https://github.com/apple/embedding-atlas/pull/206
* @StEvUgnIn made their first contribution in https://github.com/apple/embedding-atlas/pull/211
* @madrob made their first contribution in https://github.com/apple/embedding-atlas/pull/213
* @bduhan made their first contribution in https://github.com/apple/embedding-atlas/pull/207
* @dependabot[bot] made their first contribution in https://github.com/apple/embedding-atlas/pull/216
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.21.0...v0.22.0
v0.21.02026-06-01
New features
- PageRank-based image summarizer — cluster labels can now show a representative image instead of text. New --pagerank flag (computes PageRank from the neighbor graph, or accepts a precomputed column) and --image flag in the CLI; new image/importance options across the Python and JS APIs.
- WebGPU acceleration for UMAP & NN-descent — opt-in gpu option runs the projection and nearest-neighbor descent on the GPU for large speedups in the browser, with WGSL shaders and CPU fallback. Both now also accept a progress callback.
- Redesigned viewer UI — new sidebar, multiple layout tabs, undo/redo history, and a centralized state store. Adds an import/export panel and schema/search/settings panels.
- UMAP options in the file loader — configure nneighbors, mindist, and related UMAP settings directly from the loader, plus minor usability improvements.
- Python API improvements — widget now works with any narwhals-supported dataframe (pandas, Polars, etc.) rather than pandas only.
- onPredicateChange callback — viewer notifies when the filter predicate changes from brush/click interactions.
Breaking changes
Component library (@embedding-atlas/component)
- Label.text renamed to Label.content and retyped to LabelContent (a string or an image reference).
- queryClusterLabels now returns Promise<(LabelContent | null)[]> instead of Promise<(string | null)[]> (strings still work at runtime).
Viewer API (EmbeddingAtlas)
- EmbeddingAtlasState reshaped: layout → currentLayout, layoutStates → layouts (+ new layoutOrder); timestamp and predicate fields removed. Old serialized state won't fully restore.
- Searcher.nearestNeighbors() method removed; nearest neighbors now come from the neighbors column.
umap-wasm (@embedding-atlas/umap-wasm)
- UMAP.run() is now async (Promise<void>) — callers must await it.
Python backend (embedding-atlas)
- EmbeddingAtlasWidget.selection("arrow") now returns a pyarrow.RecordBatchReader instead of a pyarrow.Table.
- EmbeddingAtlasWidget.selection("dataframe") returns a dataframe in the input's native namespace (via narwhals), not always pandas.
- utils.arrowtobytes() narrowed to accept only RecordBatchReader; toparquetbytes() takes IntoDataFrame.
- Dependency bumps requiring a newer runtime: pandas >= 3.0.0, pyarrow >= 24.0.0, duckdb >= 1.5.0, sentence-transformers >= 5.0.0, and others; fastparquet dependency removed.
What's Changed
* feat: PageRank-based image summarizer by @polochau in https://github.com/apple/embedding-atlas/pull/192
* feat: improve UMAP performance on browser with WebGPU by @donghaoren in https://github.com/apple/embedding-atlas/pull/194
* feat: configure UMAP options in the file loader, and minor usability improvements by @donghaoren in https://github.com/apple/embedding-atlas/pull/196
* feat: python API improvements by @domoritz in https://github.com/apple/embedding-atlas/pull/197
* refactor: cargo workspaces and fix clippy issues by @domoritz in https://github.com/apple/embedding-atlas/pull/198
* fix: prevent embedding view hover tooltip from getting stuck by @sheitabrk in https://github.com/apple/embedding-atlas/pull/199
* fix: update labels when provided after mount by @kiwigitops in https://github.com/apple/embedding-atlas/pull/201
* feat: new sidebar UI, tabs, undo, and centralized store by @donghaoren in https://github.com/apple/embedding-atlas/pull/202
* fix: treat low-cardinality float columns as continuous in legends by @adityasingh2400 in https://github.com/apple/embedding-atlas/pull/200
* chore: update deps and bump version to 0.21.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/203
New Contributors
* @polochau made their first contribution in https://github.com/apple/embedding-atlas/pull/192
* @sheitabrk made their first contribution in https://github.com/apple/embedding-atlas/pull/199
* @kiwigitops made their first contribution in https://github.com/apple/embedding-atlas/pull/201
* @adityasingh2400 made their first contribution in https://github.com/apple/embedding-atlas/pull/200
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.20.0...v0.21.0
v0.20.02026-04-06
New Features
* Date/time data type (e.g., TIMESTAMP) support in charts.
* New UMAP implementation in Rust for the browser version (cli version still rely on Python).
New computeprojection API for computing embedding and projection of a column in a data frame. Replacing computetextprojection etc. With better request handling to API models, audio data support, and more secure cache.
Breaking changes**:
* createKNN is removed, and the set of UMAP algorithm parameters have changed.
computetextprojection, computeimageprojection, computevector_projection are removed.
* All existing projection cache will be invalidated.
What's Changed
* chore: update deps by @domoritz in https://github.com/apple/embedding-atlas/pull/175
* feat: time data type support by @donghaoren in https://github.com/apple/embedding-atlas/pull/185
* feat: adjust count plot category width by @donghaoren in https://github.com/apple/embedding-atlas/pull/186
* feat: replace basic cache with an encrypted cache to prevent leaking information by @donghaoren in https://github.com/apple/embedding-atlas/pull/187
* feat: replace the C++ UMAP with Rust based on the original Python version by @donghaoren in https://github.com/apple/embedding-atlas/pull/188
feat!: new computeprojection API by @donghaoren in https://github.com/apple/embedding-atlas/pull/189
* chore: bump version to 0.20.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/190
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.19.1...v0.20.0
v0.19.12026-03-24
What's Changed
* CRITICAL: Mitigation for supply chain attack in litellm in https://github.com/apple/embedding-atlas/pull/183, thanks @jamesanto
* chore: bump version to 0.19.1 by @donghaoren in https://github.com/apple/embedding-atlas/pull/184
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.19.0...v0.19.1
v0.19.02026-03-23
New Features
* Audio data support: in the tooltip / instances view, audio data can be shown as a audio player.
What's Changed
* test: update python deps and initial pytest setup for backend folder by @donghaoren in https://github.com/apple/embedding-atlas/pull/173
* feat: special color for 0 in counts by @domoritz in https://github.com/apple/embedding-atlas/pull/178
* ci: update versions of ci packages by @domoritz in https://github.com/apple/embedding-atlas/pull/176
* feat: support audio data with a audio player by @donghaoren in https://github.com/apple/embedding-atlas/pull/179
* chore: bump version to 0.19.0 by @donghaoren in https://github.com/apple/embedding-atlas/pull/180
* fix: valueKind function doesn't handle null values by @donghaoren in https://github.com/apple/embedding-atlas/pull/181
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.18.1...v0.19.0
v0.18.12026-03-12
What's Changed
* fix: table header backdrop-blur may not work by @donghaoren in https://github.com/apple/embedding-atlas/pull/168
* fix: minor MCP-related issues by @donghaoren in https://github.com/apple/embedding-atlas/pull/171
* chore: bump version to 0.18.1 by @donghaoren in https://github.com/apple/embedding-atlas/pull/172
Full Changelog: https://github.com/apple/embedding-atlas/compare/v0.18.0...v0.18.1