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                                        # every source with a from: line in murakumo.yaml
murakumo add column dim_customer email string --pii    # add or remove sources, entities, columns, relationships
murakumo rename entity lineitem order_line             # relationships, mappings and the file follow
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.1.1

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.1.1
File Size Uploaded Provenance Actions
murakumo-0.1.1.tar.gz 272.4 kB With provenance Details for murakumo-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 538.9 kB

Release files / murakumo-0.1.1.tar.gz

Download URL murakumo-0.1.1.tar.gz
Size 272.4 kB
Tags Source
SHA-256 checksum
How to use checksums
02d1e9cd599a998c0f040768900464b816a302c4b2e23020229e6ac4c59aa56f
BLAKE2b-256 checksum
How to use checksums
4c261a6de56d0381278a48620a0cbd08879a9b48f01b527cfecbbd22485ddde9
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.1.1-py3-none-any.whl

Download URL murakumo-0.1.1-py3-none-any.whl
Size 266.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ba489abd5085da36b94e0dc9a64436e7ee155b95b077a22bffcf2d2dcb90066d
BLAKE2b-256 checksum
How to use checksums
a7294616a52b3c92a3e255cfb2fc587d6424a0ae8b86f8364d2afa03a73853f8
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.1.1

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.1.1.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