Skip to content

Install

From a release

Each release ships a binary for every supported target, with a checksum beside it. Download the pair from the releases page, check it, and put hql somewhere on your PATH:

shasum -a 256 -c hql-<version>-<target>.tar.gz.sha256   # sha256sum -c on Linux
tar -xzf hql-<version>-<target>.tar.gz

The targets are x86_64-unknown-linux-gnu, aarch64-apple-darwin and x86_64-apple-darwin. Verify the archive against the published SHA-256 checksum before extracting it.

With Cargo

With Rust 1.95 or newer from rustup:

cargo install hql --locked                                   # the last release
cargo install --git https://github.com/ewiger/hql --locked   # the latest commit
cargo install --path . --locked                              # from a clone

Check it works

hql eval '40 + 2'
42

hql builtins lists every step a pipeline may use, grouped by the module that declares it, each with the package providing it.

Packages

hql runs with nothing else installed. A package adds modules that are not part of it, such as ml, and is built on your machine by hql package install, which needs cargo from rustup. Installing packages has the commands.

Versions

While the major version is 0, a minor release may change the language incompatibly. The changelog lists each such change by release.