Installation

Install ilusm

Official builds are installers and a minimal bundle (prebuilt stage‑0, ilusm.ilbc, lib/**/*.ilu, drivers, editor + file‑icon assets). Grab the right file from Download; what ships in the tree is documented there.

Linux (.deb)

1

Download ilusm_<version>_amd64.deb or _arm64.deb from Download (match your CPU).

2

Install:

sudo apt install ./ilusm_0.1.0_amd64.deb

3

Run:

printf '%s\n' 'prn("hi")' > hi.ilu
ilusm hi.ilu

You should see hi printed. The .deb depends on python3 for host tooling some stdlib paths expect.

macOS (.pkg)

Download ilusm_<version>_darwin_arm64.pkg or _darwin_x86_64.pkg from Download, open it, and complete Installer.app. You get /usr/local/ilusm and ilusm on your PATH via /usr/local/bin/ilusm.

printf '%s\n' 'prn("hi")' > hi.ilu
ilusm hi.ilu

Windows (.exe)

Run ilusm-<version>-x64-Setup.exe from Download. The installer adds the install directory to your user PATH.

Use PowerShell (ilusm.ps1 in the install folder) or Git Bash and run ./ilusm from that folder. Some workflows need Git for Windows or MSYS2 for bash.

cd "C:\Program Files\Ilusm"
.\ilusm.ps1 ..\path\to\hello.ilu

Docker

Install the .deb inside a Debian- or Ubuntu-based image (adjust URL/version):

FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y curl ca-certificates python3
ARG ILUSM_DEB_URL=https://ilusm.dev/dist/ilusm_0.1.0_amd64.deb
RUN curl -fsSL -o /tmp/ilusm.deb "$ILUSM_DEB_URL" \
  && apt-get install -y /tmp/ilusm.deb \
  && rm /tmp/ilusm.deb
ENV ILUSM_HOME=/usr/share/ilusm
CMD ["ilusm", "/usr/share/ilusm/hello.ilu"]

What you get

ilusm - launcher that runs the prebuilt stage‑0 runner against ilusm.ilbc and your lib/ tree.
lib/**/*.ilu - full language + stdlib sources shipped with the bundle; what runs in practice still depends on the host contract and implemented syscalls.
Editor + file icons - see vscode-extension/ and file-icons/ inside the install root.