The recommended way to get the MUFL toolchain is to install the prebuilt binaries. You get mufl-compile (the compiler) and mufl (the REPL), without cloning a repository, installing Rust, or running Emscripten.

Coming soon. First-class binary releases are on the roadmap and not yet published. Until they land, install from source — see Build from source — Linux or Build from source — macOS. The source build is functionally identical; the binary release simply removes the build step.

What the binary release will contain

A platform archive (Linux x86-64 first, macOS arm64 + x86-64 and Linux arm64 to follow) shipping:

  • mufl-compile — the MUFL compiler. Reads .mufl / .mu / .mm sources, writes content-addressed .muflo artifacts.
  • mufl — the MUFL REPL. Useful for quick experiments and for running compiled .muflo files outside an embedding application.
  • The MUFL standard library (mufl_stdlib/) and the meta and transactions libraries, in the layout the compiler expects.

How to install (planned)

The expected install paths are:

  • A curl | sh installer that downloads and extracts the right archive for your platform and adds the binaries to a directory on your PATH.
  • Homebrew formula on macOS.
  • A .deb package on Debian / Ubuntu.

After installing

Once mufl-compile is on your PATH, you do not need this repository checked out to compile MUFL. The next steps are: