Ready to start mapping?
Satsuma is open source and free. Install the CLI and write your first mapping in minutes.
Choose a path based on your role. Whether you review mappings, build pipelines, or automate with AI, there is a learning track for you.
From zero to your first validated mapping in under two minutes.
# Universal — works on macOS, Linux, and Windows
npm install -g https://github.com/thorbenlouw/satsuma-lang/releases/download/v0.7.0/satsuma-cli-v0.7.0.tgzRequires Node.js 18+. One universal package works on every platform (WASM-based, no native compilation). Available from the v0.7.0 release. Also available: latest unstable build.
# Download from the latest release, then:
code --install-extension vscode-satsuma-v0.7.0.vsixDownload vscode-satsuma-v0.7.0.vsix from the v0.7.0 release. Also available: latest unstable build. Get syntax highlighting, real-time diagnostics, go-to-definition, IntelliSense, lineage visualisation, and more.
See all extension features →.stm fileschema source {
name STRING
}
schema target {
full_name STRING
}
mapping {
source { `source` }
target { `target` }
name -> full_name
}Define schemas, then connect them with a mapping block. The -> arrow reads as "maps to".
satsuma validate my-mapping.stmThe parser checks syntax, reference resolution, and structural correctness. Zero errors means you are ready to go. The VS Code extension also shows diagnostics in real time as you type.
Explore all 21 commands →Every role interacts with data mappings differently. Find the resources that match your workflow.
Product managers, product owners, and business analysts — read, review, and sign off on data mappings without learning to code.
Build, validate, and trace data pipelines with parser-backed tooling.
validate Check syntax and referenceslint Enforce conventions with auto-fixlineage Trace field-level data flowgraph Visualize workspace structurediff Compare mapping versionsThe examples gallery includes real-world patterns: multi-source joins, SCD Type 2, Kimball star schemas, and more.
Browse examples →Map complex interchange formats: EDI, XML, COBOL copybooks, Protobuf, and more.
Satsuma handles deeply nested structures, repeating segments, and format-specific idioms natively. Each schema format convention documents how to represent the format's structures in Satsuma.
Trace every field from source to target. PII tags, encryption markers, and lineage are structural.
lineage Trace data flow end-to-endwhere-used Find all consumers of a fieldfind --tag Search by metadata taggraph Dependency visualisationThe governance example demonstrates owner, steward, classification, retention, masking, encryption, and compliance tokens. See also the Governance Convention Guide.
View governance examples →Build reliable AI workflows with a constrained grammar that LLMs can generate and validate.
satsuma agent-referenceAlso available via the CLI for piping into agent prompts.
Use AI to generate initial mappings from source documentation, then validate with the CLI, review with humans, and iterate. The constrained grammar means fewer hallucinations and reliable round-tripping.
Model entire data platforms with namespaces, imports, and workspace-wide analysis.
Use a platform entry point file with import statements to pull definitions across domains. Then use satsuma graph to visualize the whole platform.
Specifications, references, tooling guides, and technical deep-dives.
Satsuma is open source and free. Install the CLI and write your first mapping in minutes.