Base ComputeDocs

Engine releases

The BaseRT engine is distributed as a prebuilt binary bundle under Releases. This repository — the CLI, format, headers, bindings, and docs — is open source (Apache-2.0). The engine binary itself is proprietary (see the LICENSE included in the bundle); it is provided ready-to-use, so you never need to build it from source.

What a release contains

basert-engine-macos-arm64-<version>.tar.gz:

  • libbaseRT.dylib — the engine shared library, with the compiled Metal kernels embedded (a single self-contained file; no sidecar .metallib).
  • baseRT.metallib — the standalone kernel library (for tools that link the static engine).
  • basert-* CLI tools — basert-serve, basert-chat, basert-complete, basert-bench, basert-inspect, basert-transcribe.
  • include/baseRT/ — the public headers matching this release.

Installing a release

gh release download --repo basecompute/baseRT --pattern 'basert-engine-macos-arm64*.tar.gz'
mkdir -p build && tar -xzf basert-engine-macos-arm64*.tar.gz -C build
export PATH="$PWD/build:$PWD/base-convert/target/release:$PATH"

See Installation for the full setup, including building the basert CLI and putting everything on your PATH.

Versioning

Releases are versioned (<version> in the archive name) and the bundled include/baseRT/ headers match the libbaseRT.dylib in the same release — always use headers and dylib from the same release to keep the C ABI consistent. The bindings in this repo target the latest engine release.