Skip to content

Installing ESDM

This guide shows how to install ESDM and verify that it's working correctly. It covers macOS, Linux, and Windows. At the end, you will have a working esdm binary, ready to lint and view your models.

ESDM is distributed as pre-built binaries for your operating system and CPU architecture. Download the binary, place it in your project, and you're done.

Downloading the Latest Version

To get the latest version of ESDM, select your operating system and CPU architecture:

Architecture Version Download Size SHA256
ARM64 0.12.0 Download 9.4 MB 68ab6e3ccc130f99cc01bc61b22bf8d4facf274fc5521f672c5cc720a3f8db5a
x86 0.12.0 Download 10.0 MB 806291ad11b71ebc7f29ce1036d4389828446c2fea28cc0d11843d0df9f5daa5
Architecture Version Download Size SHA256
ARM64 0.12.0 Download 9.2 MB 2fd3477151aa78d83b65ae83dea6732ea9aa7b4b40d203d096dc264dab3318eb
x86 0.12.0 Download 9.9 MB 635d10c78bb1f1413d65a8a96f0d11e90e8de26e36b8301ff69f101ca8853768
Architecture Version Download Size SHA256
ARM64 0.12.0 Download 9.4 MB a0a8356f2bf289feccc44b6c789caf70e4cdbece0c1576f2af449f1adf47ac28
x86 0.12.0 Download 10.2 MB b598d766e87a6d5b098123c6394ae2af1ccb11220ba311417f343cc69b645019

Post-Download Steps

Renaming the Binary

Rename the binary for simpler usage:

mv esdm-darwin-arm64 esdm

mv esdm-linux-arm64 esdm

ren esdm-windows-arm64.exe esdm.exe

Note for x86 Users

Replace arm64 with amd64 in the file name if you are using an x86 architecture.

Making the Binary Executable

The ESDM binaries are not signed. The steps below get an unsigned binary past your operating system's default protections.

Files downloaded from the internet are marked with a quarantine attribute by macOS, which prevents them from being run. Remove the quarantine attribute:

xattr -d com.apple.quarantine esdm

Make the binary executable:

chmod a+x esdm

Make the binary executable:

chmod a+x esdm

Files downloaded from the internet are marked with a "Mark of the Web", which makes SmartScreen block the binary as coming from an unknown publisher. Remove that mark:

Unblock-File .\esdm.exe

If SmartScreen still shows a "Windows protected your PC" dialog on first run, choose More info and then Run anyway.

Verifying the Installation

After renaming and adjusting permissions, verify the installation by checking the version:

./esdm version

./esdm version

esdm version

This command will display the installed version of ESDM. If the version number matches your expectation, the installation was successful.

Where to Go Next

  • Your First Model with AI drafts a tiny ESDM model through a short conversation with a coding agent that reads the schemas for you.
  • Your First Model by Hand walks through writing and linting a tiny ESDM model from scratch, artifact by artifact.
  • Editor Support sets up your editor so it offers autocomplete and validation against the ESDM schemas.
  • Concepts is the canonical introduction to the ESDM vocabulary – Aggregates, Events, Commands, and the rest.