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

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.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.1.0
File Size Uploaded Provenance Actions
murakumo-0.1.0.tar.gz 260.8 kB With provenance Details for murakumo-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 516.3 kB

Release files / murakumo-0.1.0.tar.gz

Download URL murakumo-0.1.0.tar.gz
Size 260.8 kB
Tags Source
SHA-256 checksum
How to use checksums
845c0d05cd4eb29ff7edd1b72027793d308b8c0090b8c9f3f6439fbf974f4d39
BLAKE2b-256 checksum
How to use checksums
403cafc3bbb2590b9c710f3f1b730971fa2b0ed968d3704a7f427d724be80cf4
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 27, 2026.

Transparency log

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

Download URL murakumo-0.1.0-py3-none-any.whl
Size 255.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
83a5a2ac50f8aa7b2a3e3f56bd8111887ccb98c4dec70c4daf851129dac1c452
BLAKE2b-256 checksum
How to use checksums
973567222c118bbe79a7c58f1aaaba9fde5d5e005900ddf3ffb3dd0e2772a053
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 27, 2026.

Transparency log

Security for murakumo 0.1.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.1.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 27, 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