Installation
RuneLang is distributed as a single binary. No runtime, no package manager, no dependencies.
Download a release (recommended)
Section titled “Download a release (recommended)”Grab the latest pre-built binary from GitHub Releases.
| Platform | File |
|---|---|
| Windows (x86_64) | runelang-windows-x86_64.zip |
| macOS (Apple Silicon) | runelang-macos-aarch64.tar.gz |
| macOS (Intel) | runelang-macos-x86_64.tar.gz |
| Linux (x86_64) | runelang-linux-x86_64.tar.gz |
| Linux (aarch64) | runelang-linux-aarch64.tar.gz |
Windows
Section titled “Windows”- Download
runelang-windows-x86_64.zipfrom the latest release - Extract
runelang.exe - Move it somewhere on your PATH, or add the folder to your PATH
# Apple Silicon (M1/M2/M3/M4)curl -LO https://github.com/runelang/runelang/releases/latest/download/runelang-macos-aarch64.tar.gztar xzf runelang-macos-aarch64.tar.gzsudo mv runelang /usr/local/bin/
# Intelcurl -LO https://github.com/runelang/runelang/releases/latest/download/runelang-macos-x86_64.tar.gztar xzf runelang-macos-x86_64.tar.gzsudo mv runelang /usr/local/bin/# x86_64curl -LO https://github.com/runelang/runelang/releases/latest/download/runelang-linux-x86_64.tar.gztar xzf runelang-linux-x86_64.tar.gzsudo mv runelang /usr/local/bin/
# aarch64 / ARM64curl -LO https://github.com/runelang/runelang/releases/latest/download/runelang-linux-aarch64.tar.gztar xzf runelang-linux-aarch64.tar.gzsudo mv runelang /usr/local/bin/Build from source
Section titled “Build from source”If you prefer to build from source, RuneLang requires Rust (1.75+). Get it from rustup.rs.
# clone the repositorygit clone https://github.com/runelang/runelang.gitcd runelang
# build in release modecargo build --release
# the binary is at target/release/runelang (or runelang.exe on Windows)Verify installation
Section titled “Verify installation”runelang --versionRunning programs
Section titled “Running programs”Execute a file:
runelang my_program.runeStart the REPL:
runelangThe REPL gives you an interactive environment to experiment with RuneLang. Type expressions and see results immediately.
File extension
Section titled “File extension”RuneLang source files use the .rune extension.
hello.runedungeon.runemy_module.runeNext steps
Section titled “Next steps”You’re installed. Time to write your first program.