Build from source
Sometimes you want the freshest bits—whether to contribute to Cyrus itself, test bleeding-edge features, or just peek under the compiler’s hood. Building from source is straightforward and gives you full control over the toolchain.
Prerequisites
Before you begin, make sure you have the following installed:
- Git - to fetch the source code.
- Rust 1.87-nightly.
- LLVM 18.
Also these native libraries are required:
- glibc
- clang
- clang-tools
- libffi
- ffi
- ffi-dev
- isl
- libxml2
On Linux
Update your package index first:
sudo apt update
Install the dependencies:
sudo apt install -y git \
build-essential \
clang \
clang-tools \
llvm-18 \
llvm-18-dev \
libffi-dev \
libisl-dev \
libxml2-dev \
libc6-dev
Install Rust using rustup:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
rustup toolchain install nightly-2025-01-01
rustup default nightly-2025-01-01
Verify installation:
git --version
rustc --version
llvm-config --version
MacOS (via Homebrew):
Install dependencies via Homebrew:
brew install git \
llvm@18 \
clang \
libffi \
isl \
libxml2
Ensure Homebrew’s LLVM is in your path (add to ~/.zshrc or ~/.bashrc):
export PATH="/opt/homebrew/opt/llvm@18/bin:$PATH"
Install Rust using rustup:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
rustup toolchain install nightly-2025-01-01
rustup default nightly-2025-01-01
Verify installation:
git --version
rustc --version
llvm-config --version
On Windows:
Coming soon...
Clone the Repository
git clone --depth=1 https://github.com/cyrus-lang/Cyrus.git
cd Cyrus
From the project root:
cargo build -j24
This will produce the Cyrus compiler binary in target/release/cyrus.