Installation

Quick Install

The fastest way to install Run on macOS or Linux is with the install script:

curl -fsSL https://runlang.dev/install.sh | sh

This will detect your platform and install the latest release to ~/.run/bin.

macOS

Homebrew (recommended)

The easiest way to install Run on macOS is via Homebrew:

brew install marsolab/tap/run

To upgrade to the latest version:

brew upgrade run

Install Script

Alternatively, use the install script:

curl -fsSL https://runlang.dev/install.sh | sh

DMG

Download the latest .dmg from the GitHub Releases page. Open the disk image and drag the run binary to a directory on your PATH, such as /usr/local/bin.

Linux

Install Script

curl -fsSL https://runlang.dev/install.sh | sh

Debian / Ubuntu (.deb)

Download the .deb package from the GitHub Releases page, then install it:

sudo dpkg -i run_<version>_amd64.deb

Or install directly with apt:

sudo apt install ./run_<version>_amd64.deb

Fedora / RHEL (.rpm)

Download the .rpm package from the GitHub Releases page, then install it:

sudo rpm -i run-<version>.x86_64.rpm

Or with dnf:

sudo dnf install ./run-<version>.x86_64.rpm

Arch Linux (AUR)

Run is available in the AUR as run-lang:

yay -S run-lang

Or with any other AUR helper of your choice.

Snap

sudo snap install run-lang

From Source

Building from source requires Zig version 0.15 or later.

git clone https://github.com/marsolab/runlang.git
cd runlang
zig build

The compiled binary will be at zig-out/bin/run. You can move it to a directory on your PATH:

sudo cp zig-out/bin/run /usr/local/bin/

Or install directly:

zig build -p ~/.local

Verify Installation

After installing, verify that Run is working:

run --version

You should see output like:

run 0.1.0

You can also run a quick test:

echo 'fun main() { fmt.println("Hello, World!") }' > hello.run
run run hello.run

Uninstall

Homebrew (macOS)

brew uninstall run

Install Script

Remove the binary and configuration directory:

rm -rf ~/.run

Then remove the PATH entry from your shell configuration file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish).

Debian / Ubuntu

sudo apt remove run

Fedora / RHEL

sudo dnf remove run

Arch Linux (AUR)

yay -R run-lang

Snap

sudo snap remove run-lang

From Source

Simply remove the binary from wherever you placed it:

sudo rm /usr/local/bin/run

Note about Zig

Run’s compiler is written in Zig, a systems programming language focused on correctness and performance. If you are building from source, you need Zig version 0.15 or later installed on your system.

You can install Zig from ziglang.org/download or via your system’s package manager:

# macOS
brew install zig

# Arch Linux
pacman -S zig

# Using zigup (cross-platform)
zigup 0.15.0