Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

Milang is built from source using the Haskell toolchain and compiles programs to C via gcc.

Pre-built Binaries

Automated builds for Windows, macOS, and Linux (static) are available at: https://github.com/klarh/milang/actions/workflows/build.yml

Download the artifact for your platform from any successful workflow run — no Haskell toolchain needed.

Prerequisites

You need three things installed:

ToolMinimum versionPurpose
GHC9.6+Haskell compiler (builds the milang compiler itself)
cabal3.10+Haskell build tool
gccany recentC compiler (milang emits C, then calls gcc to produce binaries)

Ubuntu / Debian

sudo apt install ghc cabal-install build-essential

Arch Linux

sudo pacman -S ghc cabal-install base-devel

macOS (Homebrew)

brew install ghc cabal-install gcc

Building from Source

Clone the repository and build:

git clone <repository>
cd milang
make

make runs cabal build inside the core/ directory.

If you prefer to do it manually:

cd core
cabal update
cabal build

For a statically linked compiler build (Linux) using Podman, you can use the provided Makefile in the core/ directory:

cd core
make -f Makefile.static
# now ./milang is available

Verifying the Installation

Start the REPL to confirm everything works:

./milang repl

You should see a λ> prompt. Try evaluating an expression:

λ> 2 + 3
5

Press Ctrl-D to exit.

Run the test suite to make sure the compiler is healthy:

make test

This compiles and runs every .mi file in the repository’s test suite. A successful run prints something like Passed: 60, Failed: 0.