Official distribution

Download & install

Install Ilusm with a platform package: .deb (Debian/Ubuntu and derivatives), a Windows .exe (NSIS; filename ends in -Setup.exe), or a macOS .pkg (opens in Installer.app). All ship the same minimal runtime bundle — prebuilt stage‑0, ilusm.ilbc bytecode, lib/ sources, drivers, VS Code extension, and file icons.

How to install

Linux (.deb — Debian/Ubuntu)

sudo dpkg -i ilusm_0.2.0_amd64.deb
# If dependency errors:
sudo apt-get install -f

# Test installation
ilusm --version
ilusm hello.ilu

Linux (.rpm — Fedora/RHEL/CentOS)

sudo rpm -i ilusm-0.2.0-1.x86_64.rpm

# Test installation
ilusm --version
ilusm hello.ilu

Linux (.run — Universal installer)

chmod +x ilusm-0.2.0-linux-x86_64.run
./ilusm-0.2.0-linux-x86_64.run

# Follow prompts, then:
~/ilusm/ilusm --version

Linux (.tar.gz — Portable)

tar -xzf ilusm-linux-x86_64.tar.gz
cd ilusm
./ilusm hello.ilu

Windows (.exe installer)

1. Download ilusm-0.2.0-x64-Setup.exe (requires admin) or ilusm-0.2.0-x64-UserSetup.exe (no admin)
2. Double-click to run the installer
3. Follow the wizard (accept defaults or customize install location)
4. Important: Close and reopen your terminal/PowerShell window
5. Test: ilusm --version

Windows (.zip — Portable)

1. Extract ilusm-windows-x86_64.zip to a folder
2. Open Command Prompt or PowerShell in that folder
3. Run: ilusm.cmd hello.ilu or in PowerShell: ./ilusm.ps1 hello.ilu

macOS (.tar.gz — Portable)

tar -xzf ilusm-darwin-arm64.tar.gz  # or darwin-x86_64
cd ilusm
./ilusm hello.ilu

Note: macOS .pkg installer coming soon. The tarball works on both Intel and Apple Silicon Macs.

Troubleshooting

Windows: "Windows protected your PC" / SmartScreen warning

The installer is not codesigned (expensive), so Windows may show a warning. Click "More info" then "Run anyway" to proceed.

Windows: "ilusm is not recognized" after install

The installer adds ilusm to your PATH, but you must restart your terminal (Command Prompt, PowerShell, or VS Code) for the change to take effect.

Windows: "Missing stage-0 binary" error

This happens if the ilusm-min.exe seed file is missing or can't be found. Reinstall, or use the .zip portable version which doesn't require installation.

Linux: "command not found" after .deb install

The .deb installs to /usr/bin/ilusm. If not found:

hash -r  # Refresh shell PATH cache
# Or log out and back in

Linux: dpkg dependency errors

If you see errors about python3:

sudo apt-get install -f  # Fix dependencies

All platforms: "no stage-0 seed" error

The stage0 binary for your platform is missing from the install. Check that:

• stage0/windows-x86_64/ilusm-min.exe exists (Windows)
• stage0/linux-x86_64/ilusm-min exists (Linux x64)
• stage0/darwin-arm64/ilusm-min exists (macOS ARM)

If missing, reinstall or download a fresh copy.

All platforms: "ilusm.ilbc not found"

The compiler bytecode is missing. Reinstall, or if building from source, run ./ilusm compile first.

macOS: "cannot open ilusm-min" (permission denied)

macOS quarantine may block unsigned binaries:

xattr -dr com.apple.quarantine ./ilusm
xattr -dr com.apple.quarantine stage0/darwin-*/ilusm-min

Still having issues?

Try the portable version (.zip for Windows, .tar.gz for Linux/macOS) — extract and run directly without installation. If that works, the issue is with the system integration (PATH, permissions).

For more help: Full install docs or check the FAQ.

What each installer adds

Layout on disk

After install, the toolchain layout matches the tarball: lib/stdlib/, release/examples/, docs/, and related trees under $ILUSM_HOME. See Bundle layout for a short map.

After install

• Installation details
• Get started
• Loveshack
• Language reference
• Standard library
• Self-hosting