Skip to main content

Murakumo

Model-first data engineering. Design the logical model (entities, relationships, mappings) on a canvas, and Murakumo generates and maintains everything downstream: DDL, dbt projects, Spark and Python jobs, streaming configs, tests, audit tables, data contracts and orchestration, on an open lakehouse.

Alpha. Working today: the model, importers, validation, the canvas, dbt and DDL generation, migrations, and builds verified on DuckDB and Snowflake. Source: github.com/murakumo-data/murakumo.

Install

pip install "murakumo[canvas,verify,duckdb]"
murakumo init my_platform        # asks about your warehouse and orchestrator, then shows what to set up
cd my_platform
murakumo setup                   # checks drivers, variables, keys and connections; says what to do
murakumo canvas                  # the visual editor

Usage

murakumo init my_platform --target snowflake --yes   # or answer with options, without questions
cd my_platform
murakumo setup --connect         # also test the warehouse and source connections
murakumo validate                # check the manifest and model; exits 1 on errors
murakumo validate --fix          # write stable ids into hand-written YAML
murakumo validate --strict       # fail on warnings too (useful in CI)
murakumo validate --format json  # machine-readable diagnostics
murakumo schema entity           # JSON Schema for editors: manifest, model, entity, source, relationship

murakumo import csv dictionary.csv                     # or: excel, database, file, openapi, json
murakumo import database env:ERP_URL --source erp      # needs murakumo[postgres] or murakumo[duckdb]
murakumo import database env:ERP_URL --source erp --table sales.orders   # only some tables
murakumo import                                        # every source with a from: line in murakumo.yaml
murakumo add column dim_customer email string --pii    # add or remove sources, domains, entities, columns, relationships
murakumo rename entity lineitem order_line             # relationships, mappings and the file follow
murakumo move column dim_customer email --after name   # reorder columns
murakumo add domain finance --owner "Finance team"     # domains become dbt groups
murakumo lineage fct_trip.trip_id                      # where a column comes from; --down for what uses it
murakumo canvas                                        # the visual editor, on http://127.0.0.1:8765

murakumo generate                                      # generated/: dbt project and DDL for your warehouse
murakumo generate --check                              # fail CI if generated/ is out of date
murakumo migrate                                       # ALTER statements for tables that keep data
murakumo verify                                        # build and test it all on DuckDB, twice
murakumo verify --warehouse snowflake                  # or on Snowflake, in throwaway schemas
murakumo build --sample 200                            # build into the project's warehouse and keep the tables
murakumo config --target snowflake                     # change the answers you gave init
murakumo --help                                        # every command, with what it does

Extras: canvas (the editor), verify (builds on DuckDB), duckdb (files and DuckDB), postgres, snowflake. murakumo setup tells you which a project needs.

Docs: starting a project and setting up, model files and validation rules, importing metadata, generating and verifying, Snowflake, the canvas.

Development

uv sync
uv run murakumo --version
uv run pytest
uv run ruff check
uv run ruff format --check

Metadata

Release files for murakumo 0.2.0

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

Source distribution (sdist)

Source distribution for murakumo 0.2.0
File Size Uploaded Provenance Actions
murakumo-0.2.0.tar.gz 301.1 kB With provenance Details for murakumo-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 595.0 kB

Release files / murakumo-0.2.0.tar.gz

Download URL murakumo-0.2.0.tar.gz
Size 301.1 kB
Tags Source
SHA-256 checksum
How to use checksums
05708558467221d7f5868627abe7a77951df364d7746282959c2733d5a6fc225
BLAKE2b-256 checksum
How to use checksums
ba0249b56c6c4a66f9f72bbaa192b200b99b376eca825387d94dc640da3dd983
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / murakumo-0.2.0-py3-none-any.whl

Download URL murakumo-0.2.0-py3-none-any.whl
Size 293.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
beaed0781f024620fbd0cfb28c6f29b12747d299994279f8a5845ab2d9117a7a
BLAKE2b-256 checksum
How to use checksums
d47658cc63d0b8c6972a217c6f01f7ba61854eee85fac16947de57fb401467f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for murakumo 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for murakumo-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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