Skip to content

Changelog

All notable user-facing Metaxy changes are to be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning, except for experimental features.

While Metaxy's core functionality and versioning engine are stable and quite complete, the CLI and some of the more advanced APIs and integrations are considered experimental.

Abstract

stable features are guaranteed to follow SemVer and won't receive breaking changes in between minor releases. Such changes will be announced with a deprecation warning. A feature is considered stable if it's documented and doesn't have an "Experimental" badge.

experimental features may be changed or removed at any time without deprecation warnings. They may be documented and in this case must display an "Experimental" warning badge:

Experimental

This functionality is experimental.

v0.1.9 (03-04-2026)

🗑 Deprecated

  • MetadataStore implementations have been moved from metaxy.ext.metadata_stores.<store> to metaxy.ext.<store>. Old import paths are deprecated and will be removed in 0.2.0.

  • HashAlgorithm has been moved from metaxy.versioning.types to metaxy._hashing (is available as metaxy.HashAlgorithm). The old import path is deprecated and will be removed in 0.2.0.

✨ Features

Map datatype

  • narwhals-map is now used for Map datatype operations in Narwhals. This changes the Narwhals datatype from Unknown to narwhals_map.Map and exposes nw.Expr.map namespace for these columns. (#1167 by @danielgafni)

📖 Docs

Map datatype

🛠 Other Improvements

Claude

v0.1.8 (01-04-2026)

✨ Features

Claude

Cli

Ray

🐛 Bug Fixes

  • remove missing lock file warning when metaxy_lock_path is not configured (#1143 by @danielgafni)
  • improve Map datatype support in MetadataStore.resolve_update (#1139 by @danielgafni)

📖 Docs

Sqlmode

🛠 Other Improvements

Ray

v0.1.7 (28-03-2026)

This release adds experimental support for the Map datatype and a new Apache Iceberg metadata store.

✨ Features

  • A new experimental enable_map_datatype global setting has been added to Metaxy's configuration. When enabled, it uses polars-map (must be installed) to preserve the Arrow Map type on Polars frames across Metaxy operations. (#1104 by @danielgafni)

Claude

Clickhouse

Duckdb

Deltalake

Iceberg

🐛 Bug Fixes

Dagster

Iceberg

📖 Docs

Iceberg

🛠 Other Improvements

Ducklake

❤ New Contributors

v0.1.6 (18-03-2026)

🐛 Bug Fixes

Sqlalchemy

  • the SQLAlchemy integration configuration ([ext.sqlalchemy] in metaxy.toml) has been removed. Please use the code interface instead. (#1075 by @danielgafni)

Sqlmodel

  • the SQLModel integration configuration ([ext.sqlmodel] in metaxy.toml) has been removed. Please use the code interface instead. (#1074 by @danielgafni)

📖 Docs

🛠 Other Improvements

v0.1.5 (18-03-2026)

✨ Features

🐛 Bug Fixes

📖 Docs

🛠 Other Improvements

❤ New Contributors

0.1.4 (12-03-2026)

🐛 Bug Fixes

  • Fixed a bug with metaxy push not re-pushing feature definitions on changes reverting them to a previous version.

0.1.3 (11-03-2026)

✨ Features

  • metaxy lock now avoids loading feature definitions from metaxy.project entrypoints of Python packages that aren't dependencies (direct or transitive) of the current Python package when creating the lock file.

🔧 Changed

  • Renamed metaxy graph history CLI command to metaxy history

📖 Docs

  • Added a section on inheritance with Metaxy features
  • Improved Dagster integration docs

0.1.2 (06-03-2026)

✨ Features

  • A new staleness_predicates parameter has been added to resolve_update. It can be used to mark records as stale based on arbitrary Narwhals expressions, regardless of their Metaxy versions.
  • MetadataStore.write now fills metaxy_data_version and metaxy_data_version_by_field values in place of Nulls on per-row basis instead of checking whether the whole column presence.
  • Added Rebases functionality which allows backfilling metadata from historical feature versions. It's available via CLI or as MetadataStore.rebase.

0.1.1 (27-02-2026)

✨ Features

  • A new top-level extra_features configuration option has been added. It can be used to register additional external feature definitions from the metadata store on the feature graph. Learn more here.
  • DuckLake integration has been revamped, tested, and documented. Thanks @geoHeil!

🐛 Bug Fixes

  • Fixed DuckDBMetadataStore assuming "community" extension repo instead of "core" when loading extensions with unspecified repos
  • Fixed /metaxy skill and metaxy MCP server not being properly installed by the Claude plugin
  • (💥 breaking) Fixed a bug where MetadataStore erroneously did not require being opened with "w" write mode before writing data
  • Fixed a bug where MetadataStore would not properly handle nested context manager calls

0.1.0 (13-02-2026)

The first public Metaxy release 🎉!

This release should be considered an alpha release: it is ready for production use and has been dogfooded internally at Anam.ai, but we don't have any community feedback yet.

✨ Features

⚗ Experimental