Installing the Hylo compiler

We ship pre-built portable binary archives as part of our release process.

Supported platforms

The prebuilt archives target:

Platform	Architectures	Minimum version
Linux	x64, arm64	glibc 2.39+ (Ubuntu 24.04+)
macOS	Apple silicon, Intel	macOS 26+
Windows	x64, arm64	Windows 11

On a platform not listed here, you need to build from source instead.

Prerequisites

Linux

Hylo requires clang on PATH for linking, and for compiling the standard library shims.

sudo apt install clang tar zstd

macOS

Hylo requires clang and xcrun on PATH for linking, and for compiling the standard library shims.

xcode-select --install

Windows

Hylo requires clang on Path for linking, and for compiling the standard library shims.

Install Visual Studio with the “Desktop development with C++” workload including clang, or a clang release.

Make sure clang is on Path. When using VS, you can find it here: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\Llvm\x64\bin\

Install the Hylo compiler

Linux

Download and extract the portable archive:

x64

curl -LO https://github.com/hylo-lang/hylo-new/releases/download/v0.0.9/hylo-v0.0.9-linux-x64.tar.zst
mkdir -p "$HOME/.local/hylo" && tar --zstd -xf hylo-v0.0.9-linux-x64.tar.zst -C "$HOME/.local/hylo"

arm64

curl -LO https://github.com/hylo-lang/hylo-new/releases/download/v0.0.9/hylo-v0.0.9-linux-arm64.tar.zst
mkdir -p "$HOME/.local/hylo" && tar --zstd -xf hylo-v0.0.9-linux-arm64.tar.zst -C "$HOME/.local/hylo"

Then add it to your PATH by appending this to your terminal profile, e.g. ~/.bashrc:

export PATH="$HOME/.local/hylo:$PATH"

macOS

Download and extract the portable archive:

Apple silicon

curl -LO https://github.com/hylo-lang/hylo-new/releases/download/v0.0.9/hylo-v0.0.9-macos-arm64.tar.zst
mkdir -p "$HOME/.local/hylo" && tar --zstd -xf hylo-v0.0.9-macos-arm64.tar.zst -C "$HOME/.local/hylo"

Intel

curl -LO https://github.com/hylo-lang/hylo-new/releases/download/v0.0.9/hylo-v0.0.9-macos-x64.tar.zst
mkdir -p "$HOME/.local/hylo" && tar --zstd -xf hylo-v0.0.9-macos-x64.tar.zst -C "$HOME/.local/hylo"

Then add it to your PATH by appending this to your terminal profile, e.g. ~/.zshrc:

export PATH="$HOME/.local/hylo:$PATH"

Windows

Download and extract the portable archive:

x64

curl.exe -LO https://github.com/hylo-lang/hylo-new/releases/download/v0.0.9/hylo-v0.0.9-windows-x64.tar.zst
mkdir "$env:LOCALAPPDATA\Hylo"
tar --zstd -xf hylo-v0.0.9-windows-x64.tar.zst -C "$env:LOCALAPPDATA\Hylo"

arm64

curl.exe -LO https://github.com/hylo-lang/hylo-new/releases/download/v0.0.9/hylo-v0.0.9-windows-arm64.tar.zst
mkdir "$env:LOCALAPPDATA\Hylo"
tar --zstd -xf hylo-v0.0.9-windows-arm64.tar.zst -C "$env:LOCALAPPDATA\Hylo"

Then add that folder to your Path:

[Environment]::SetEnvironmentVariable(
  "Path", "$env:LOCALAPPDATA\Hylo;" + [Environment]::GetEnvironmentVariable("Path", "User"), "User")

Verify your installation

hc --version

It should print 0.0.9.

Next step: set up your editor!