v0.17.0

New Features

• The command line tool can expose an MCP server with the --mcp flag. Now you can connect your favorite AI tool to Embedding Atlas.
• [breaking] CORS is now disabled by default for the command line tool. Use the --cors flag to enable it explicitly.
• [breaking] In compute_{text|image|vector}_embedding, parameters other than the data frame now need to be specified as keyword parameters.

What's Changed

• feat: add MCP server support for the command line tool by @donghaoren in #158
• fix: improve WebGPU device limits and fallback logic by @donghaoren in #160
• chore: bump version to 0.17.0; npm audit fix by @donghaoren in #161

Full Changelog: v0.16.1...v0.17.0

v0.16.1

What's Changed

• chore: update node version for publishing action by @donghaoren in #152
• fix: run npm audit fix by @donghaoren in #153
• chore: bump version to 0.16.1 by @donghaoren in #154

Full Changelog: v0.16.0...v0.16.1

v0.16.0

New Features

• [Breaking] Support sorting in count plot. Count plot spec redeisgned.
• [Breaking] compute_{image,text,vector}_projection functions now require keyword arguments for parameters other than the data frame.
• New command line option --with to import a python module before loading data.
• New command line option --query to run a SQL query on the loaded data frame.

What's Changed

• feat: link to resources about CORS in error by @domoritz in #134
• feat!: support sorting in count plot, improve spec by @donghaoren in #136
• fix: list layout right panel scroll bar overlap with charts by @donghaoren in #140
• feat: --with and --query cli options by @donghaoren in #144
• fix: (security) vulnerability with tar and diff packages by @donghaoren in #145
• fix: count plot may crash on null values by @donghaoren in #146
• docs: add examples page with more examples by @donghaoren in #148
• chore: npm audit fix and uv update by @donghaoren in #149
• chore: remove NODE_AUTH_TOKEN from npm publish step by @donghaoren in #150
• chore: bump version to 0.16.0 by @donghaoren in #151

Full Changelog: v0.15.0...v0.16.0

v0.15.0

New Features

• Load data from a URL with the "Load Data" button in the home page.
• The previous /upload page is renamed to /app.

What's Changed

• Upgrade GitHub Actions to latest versions by @salmanmkc in #122
• ci: upgrade GitHub Actions for Node 24 compatibility by @salmanmkc in #121
• ci: revert to recommended version tag by @domoritz in #123
• feat: allow loading data from URL by @donghaoren in #124
• fix: race condition in search and perf issues by @donghaoren in #125
• fix: typo in line chart description by @kwonoh in #129
• fix: visual glitch with downsampled points when points are ordered spatially by @donghaoren in #130
• fix: (security) preact has JSON VNode Injection issue by @donghaoren in #132
• chore: bump version to 0.15.0 by @donghaoren in #133

New Contributors

• @salmanmkc made their first contribution in #122
• @kwonoh made their first contribution in #129

Full Changelog: v0.14.0...v0.15.0

v0.14.0

New Features

• Viewport-dependent density-based downsampling. This allows the embedding view to scale to a larger number of points. Downsampling by default kicks in at 4M points. See #118 for more details. Thanks @maxdumas!

What's Changed

• fix: scroll dashboard to new chart on adding a new chart with plus button by @donghaoren in #105
• feat: move export into dedicated menu action, increase spacing between buttons by @domoritz in #104
• chore: update feature flag note by @domoritz in #106
• fix: labels may overlap when embedding view is resized by @donghaoren in #108
• feat: allow adjusting embedding view colors and ordinal colors in theme by @donghaoren in #113
• fix: overriding derived values in predicates widget by @donghaoren in #114
• fix: dependabot alert (mdast-util-to-hast) by @donghaoren in #116
• feat: add url state saving to upload page by @donghaoren in #115
• feat: add viewport-dependent density-based downsampling by @maxdumas in #118
• fix: search box may appear underneath charts in dashboard layout by @donghaoren in #120
• chore: bump version to 0.14.0 by @donghaoren in #119

New Contributors

• @maxdumas made their first contribution in #118

Full Changelog: v0.13.0...v0.14.0

v0.13.0

New Features

• Add a dashboard layout mode that allows you to freely arrange the components.
• New chart types: eCDF, line chart, and bubble chart.
• [breaking] A new DSL syntax for charts (similar to Vega-Lite), you can now create custom charts with this syntax.
• Theme support with chartTheme and stylesheet props to the EmbeddingAtlas component.
• Support rendering chat messages (data format: Array<{role: "<role>", content: "<content>"}>).
• Add a widget to show a particular column's value of the selected data point (click table or embedding plot to select a point).
• Add a widget to display custom Markdown content.
• Support multiple text embedding providers via LiteLLM (thanks @peter-gy).

Detailed Changes

• feat: support multiple text embedding providers by @peter-gy in #76
• feat: add dashboard layout by @donghaoren in #92
• feat: add markdown widget by @donghaoren in #93
• feat: messages format renderer by @donghaoren in #94
• chore: update packages by @donghaoren in #95
• feat: redesign chart spec schema, add line chart, bubble chart, and eCDF chart by @donghaoren in #97
• fix: for large x y values the embedding view disappears by @donghaoren in #98
• chore: exclude sensitive and irrelevant args from text projection hash by @peter-gy in #100
• fix: better WebGPU feature check by @donghaoren in #101
• chore: bump version to 0.13.0 by @donghaoren in #102

New Contributors

• @peter-gy made their first contribution in #76

Full Changelog: v0.12.0...v0.13.0

v0.12.0

Breaking Changes

• EmbeddingAtlasState interface has been redesigned. See the documentation for more details.

Detailed Changes

• Fix typo in table.md by @derekperkins in #70
• docs: make it clearer that the notebook works on different platforms by @domoritz in #72
• chore: restrict GitHub workflow permissions - future-proof by @incertum in #73
• refactor: re-organize charts in the viewer code and minor improvements by @donghaoren in #75
• feat: replace code editor with CodeMirror by @donghaoren in #79
• fix: table custom cell and header messed up and not updating by @donghaoren in #80
• chore: update node version in CI to 24 by @donghaoren in #82
• chore: bump version to 0.12.0 by @donghaoren in #83

New Contributors

• @derekperkins made their first contribution in #70
• @incertum made their first contribution in #73

Full Changelog: v0.11.0...v0.12.0

v0.11.0

What's Changed

• embedding-atlas command now default to server-side DuckDB. To use browser-side DuckdB, pass in --duckdb wasm.
• Python requirement is now correctly marked as >= 3.11.

Detailed Changes

• chore: add shields to README.md by @donghaoren in #61
• chore: fix typo in comment by @domoritz in #62
• test: add basic python install test by @donghaoren in #63
• fix: widgets not working in DuckDB 1.4.0 by @donghaoren in #64
• chore: update dependency requirements by @donghaoren in #65
• feat: default to server-side DuckDB by @donghaoren in #66
• chore: bump version to 0.11.0 by @donghaoren in #68

Full Changelog: v0.10.0...v0.11.0

v0.10.0

New Features & Breaking Changes

• Add --point-size cli option to override the default point size (thanks @vstenby).
• Add --labels cli option to supply custom labels.
• Add --stop-words cli option to supply custom stop words (replacing the default stop words).
• [breaking] For the EmbeddingView and EmbeddingViewMosaic components, config options are now under the config prop, with interface EmbeddingViewConfig.
• [breaking] For the EmbeddingAtlas component, data-related props are now grouped into data, and configs related to the embedding views are now under embeddingViewConfig. Additional props are included to set the point size, labels, and stop words as well.

Detailed Changes

• feat: added --point-size arg by @vstenby in #44
• test: run type checks by @donghaoren in #45
• fix: type check errors by @donghaoren in #47
• chore: fix typo captuerd -> captured by @domoritz in #49
• fix: cacheKeyForObject errors in non-secure context by @donghaoren in #52
• chore: update dependencies by @donghaoren in #53
• fix: prevent streamlit component updating needlessly by @donghaoren in #54
• feat: [breaking] add options for custom labels and automatic label parameters by @donghaoren in #55
• chore: update Mosaic to 0.19.1 by @donghaoren in #56
• fix: dark mode scroll bars by @donghaoren in #58
• fix: jupyter widget issues in vscode by @donghaoren in #59
• chore: bump version to 0.10.0 by @donghaoren in #57

New Contributors

• @vstenby made their first contribution in #44

Full Changelog: v0.9.0...v0.10.0

v0.9.0

New Features & Breaking Changes

• Adjust display style of the tooltip and search results
• Run UMAP projection from pre-computed vectors with the --vector option (thanks @nxlouie)
• Add --batch-size parameter to CLI (thanks @davanstrien)
• Generate better labels by using the Intl.Segmenter API.
• [breaking] Rename umap, knn, and findClusters APIs to camelCase.
• [breaking] queryClusterLabels now expect a function that takes a list of clusters.

Detailed Changes

• docs: document upload and that embedding atlas supports embedding and projection by @domoritz in #13
• fix: add source for stopwords by @donghaoren in #16
• chore: update deps by @domoritz in #15
• enable projection from pre-computed vectors by @nxlouie in #21
• docs: argument name for --disable/enable-projection and doc updates by @donghaoren in #22
• Add batch size parameter to CLI for Sentence Transformers by @davanstrien in #24
• fix: window install error by @donghaoren in #26
• docs: add more info about Windows by @donghaoren in #27
• chore: use npm ci in CI build by @donghaoren in #28
• refactor: move the density clustering code to its own internal package by @donghaoren in #33
• refactor: [breaking] change umap, knn, and findClusters API to camelCase by @donghaoren in #34
• docs: add information about default model and reproducibility by @donghaoren in #36
• test: build wasm modules in CI by @donghaoren in #37
• test: add tests for wasm packages by @donghaoren in #39
• refactor: [breaking] use Intl.Segmenter to generate cluster labels by @donghaoren in #38
• chore: replace wasm-pack with wasm-bindgen-cli by @donghaoren in #40
• feat: add options to customize tooltip by @donghaoren in #41
• fix: smaller font size for JSON display by @donghaoren in #42
• chore: bump version to 0.9.0 by @donghaoren in #43

New Contributors

• @nxlouie made their first contribution in #21
• @davanstrien made their first contribution in #24

Full Changelog: v0.8.0...v0.9.0