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.14.0 Download 8.5 MB b124e609df2c7066fb153b5ac294ef4bcf8fba2807eb3cbe2879c6debd958bf6
x86 0.14.0 Download 9.1 MB f9ca09548b783b214b5455cc7bc2bb8aba373b84ac2670b209657898cc75c548
Architecture Version Download Size SHA256
ARM64 0.14.0 Download 8.3 MB 891fe719fa2ea24eef9ebd229b5032d769791ac926e091a2cacfd91520edbfb4
x86 0.14.0 Download 9.0 MB c0a786972300f6f7e71e645f009b8e7b8b7967c8837daf9e51f968e756e1716e
Architecture Version Download Size SHA256
ARM64 0.14.0 Download 8.5 MB b4c9b7744d3036977eec83f11ead009a0052028cd1eec53cb8e16db68b276909
x86 0.14.0 Download 9.3 MB 95d6140572209fc3a52449180cd538da01475e97781580b1c1ed5933d0d2e2fb

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.