Installation

Jam is a statically typed systems language with mutable value semantics and an LLVM backend. The current release is v0.0.1, with prebuilt compilers for macOS and Linux.

Expect things to move. Syntax and the standard library will keep changing until v0.1, and issues and pull requests on the repository stay closed until then.

Download v0.0.1

Jam v0.0.1
Prebuilt compiler, standard library included
Download

Each archive is self-contained: the compiler, the standard library and everything it needs to link programs. Nothing else has to be installed, not even a C compiler.

Platform Archive
macOS, Apple Silicon jam-v0.0.1-aarch64-apple-darwin.tar.gz
macOS, Intel jam-v0.0.1-x86_64-apple-darwin.tar.gz
Linux, x86_64 jam-v0.0.1-x86_64-unknown-linux-gnu.tar.gz
Linux, ARM64 jam-v0.0.1-aarch64-unknown-linux-gnu.tar.gz

Download the archive for your platform, unpack it anywhere, and put its bin directory on your PATH:

curl -LO https://github.com/tri-berry/jam/releases/download/v0.0.1/jam-v0.0.1-aarch64-apple-darwin.tar.gz
tar xzf jam-v0.0.1-aarch64-apple-darwin.tar.gz
export PATH="$PWD/jam-v0.0.1-aarch64-apple-darwin/bin:$PATH"
jam version

The macOS compilers need macOS 15 or newer, and the Linux ones glibc 2.35 or newer (Ubuntu 22.04, Debian 12). The release page also has a SHA256SUMS file to check a download against.

Homebrew macOS

The formula builds the release from source and pulls in LLVM 22, LLD 22 and Rust for you. Add --HEAD to build the latest commit on main instead.

brew tap tri-berry/jam https://github.com/tri-berry/jam
brew install jam

From source Rust + LLVM 22

The compiler is written in Rust. You need the toolchain from rust-toolchain.toml (picked up automatically by rustup) plus LLVM 22 and LLD 22, either brew install llvm@22 lld@22 or LLVM_CONFIG pointing at your llvm-config and JAM_LLD_PREFIX at your LLD install.

git clone https://github.com/tri-berry/jam
cd jam
make build     # debug build
make test      # Rust unit tests + the .jam corpus under tests/
make install   # release build, installs jam + std to ~/.local

Hello, world

const std = import("std");

fn main() {
    std.fmt.println("Hello, World!");
}
jam run hello.jam

The installed jam finds the standard library relative to its own binary (<prefix>/lib/jam/std). Set JAM_STD_PATH or pass --std-path to point it somewhere else.

Linking

Jam links programs itself, with the LLD linker built into the compiler and the C library files it ships in <prefix>/lib/jam/libc. You do not need clang, gcc or the Xcode command-line tools to build a Jam program.

Both sets of files ship with every install, so cross-compiling needs nothing extra: jam -C target=x86_64-unknown-linux-musl hello.jam on a Mac produces a Linux executable.

Link other libraries with -l<name>, and add search directories with -L<dir>:

On macOS a program runs on the OS version it was built on and newer. Set MACOSX_DEPLOYMENT_TARGET (for example 12.0) to target an older release. JAM_LIBC_PATH points Jam at a different copy of the bundled files.

Next, read the Language Reference.