Skip to main content

Metaxy Logo

Metaxy

PyPI version Python versions PyPI downloads CI codecov Ruff Ty prek

Metaxy is a metadata layer for multimodal Data and ML pipelines. Metaxy tracks lineage and versioning across complex computational graphs for multimodal datasets. Metaxy can cache every single sample and scale to handle millions of them.

Metaxy manages metadata while data typically lives elsewhere:

┌─────────────────────────────────┐          ┌─────────────────────────┐
│      Metadata (Metaxy)          │          │   Data (e.g., S3)       │
├──────┬──────────┬──────┬────────┤          │                         │
│  ID  │   path   │ size │version │          │  📦 s3://my-bucket/     │
├──────┼──────────┼──────┼────────┤          │                         │
│ img1 │ s3://... │ 2.1M │a3fdsf  │ ────────>│    ├─ img1.jpg          │
│ img2 │ s3://... │ 1.8M │b7e123  │ ────────>│    ├─ img2.jpg          │
└──────┴──────────┴──────┴────────┘          └─────────────────────────┘

The feature that makes Metaxy stand out is the ability to track partial data dependencies and detect prunable updates — updates that don't trigger change propagation through certain paths in the dependency graph because they modify fields that aren't dependencies of those downstream features. For example, updating audio upstream of a face recognition step allows pruning the face recognition branch since it only depends on video frames. This problem is specific to multimodal pipelines and doesn't typically emerge in traditional data engineering.

Metaxy's goal is to provide a standard instrument for any kind of multimodal (or purely tabular) incremental pipelines, standardizing dependency specification, versioning, partial data dependencies, and manipulations over metadata. Or, in short, to be a universal glue for incremental data pipelines.

Metaxy is very reliable and is fanatically tested across all supported Python versions and platforms 1.

Documentation

Read the docs to learn more.

Installation

Install Metaxy from PyPI:

uv add metaxy

Using Metaxy

Metaxy is highly pluggable and generally can be used with any kind of incremental pipelines, storage, metadata storage, and dataframe libraries.

Metaxy provides integrations with popular tools such as Dagster, Ray, ClickHouse, DeltaLake, SQLModel.

The full list can be found here.

Blog Posts

Contributing

See CONTRIBUTING.md.

  1. The CLI is not tested on Windows yet. ↩

Metadata

Release files for metaxy 0.1.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for metaxy 0.1.11
File Size Uploaded
metaxy-0.1.11.tar.gz 255.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for metaxy 0.1.11
File Interpreter ABI Platform
metaxy-0.1.11-py3-none-any.whl Python 3 none any Details

Total release size: 582.8 kB

Release files / metaxy-0.1.11.tar.gz

Download URL metaxy-0.1.11.tar.gz
Size 255.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3dfa279f1a97001d6a448c71a38e5bd5ab9476c939a4068358137171590fbc63
BLAKE2b-256 checksum
How to use checksums
cdf112fc744be6e7e81309f22e9a846fcd11ce48064c36d7aaac8155ad2c9f07
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / metaxy-0.1.11-py3-none-any.whl

Download URL metaxy-0.1.11-py3-none-any.whl
Size 327.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cf1113d0939331cbc774b9c36d96f878fe2ad550d1024354353dd1e659f96d6f
BLAKE2b-256 checksum
How to use checksums
534f577fe66ed1ed9793a888fb08235e7aac000cf1186c4b86f619c4e4130036
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.1.11 This release

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page