Skip to content

anam-org/metaxy

Repository files navigation

Metaxy Logo

Metaxy

PyPI version Python versions PyPI downloads CI Ruff Ty prek

Metaxy is a metadata layer for multi-modal Data and ML pipelines. Metaxy tracks lineage and versioning across complex computational graphs for multi-modal 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 skip downstream updates when they are not needed.

Metaxy's goal is to provide a standard instrument for any kind of multi-modal (or just 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.

Read the docs to discover more about Metaxy.

Installation

Warning: Metaxy hasn't been publicly released yet, but you can try the latest dev release:

pip install --pre 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.

Contributing

See CONTRIBUTING.md.

Footnotes

  1. The CLI is not tested on Windows yet.

About

Pluggable sample-level metadata versioning for incremental multi-modal pipelines.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 8

Languages