Install

Chelis is developed from the repository today. Downstream users normally need the chelis CLI on PATH; shell authors also need Reef package commands.

Rust toolchain

Chelis is built with stable Rust:

rustup default stable
rustup component add rustfmt clippy

C toolchain

The C backend expects a native compiler and a BLAS provider for matmul fast paths.

Fedora / RHEL:

sudo dnf install gcc openblas-devel valgrind

Ubuntu / Debian:

sudo apt-get install gcc libopenblas-dev valgrind

macOS:

xcode-select --install

Supported macOS paths:

• Default: Apple clang plus Accelerate. This is the supported correctness path on Apple Silicon and does not require Homebrew OpenBLAS.
• Optional: Homebrew GCC for OpenMP-enabled CPU loops.

brew install gcc

Build and test the repo

From a Chelis checkout:

cargo build --workspace --all-targets
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --all -- --check

During normal downstream work, you rarely need the whole gate above. Use it when you are checking a local compiler build or preparing a change to Chelis itself.

Build the CLI

cargo build -p chelis-cli
export PATH="$PWD/target/debug:$PATH"
chelis --help

If you install a release build instead, make sure chelis --help works before starting the first program loop.

Build the book

mdbook build docs/book

Validate docs examples

cargo test -p chelis-e2e --test skill_suite

That test validates the checked chelis-surf and chelis-deep fences used as teaching examples. Fragment fences are intentionally illustrative only.