docs
// Getting Started

Downloads

Every Erebine binary ships through GitHub Releases on Erebine/binaries, and the links on this page always resolve to the latest stable release: the Erebine app for macOS, the erectl client, the Erebine Inference Microservice (EIM) and the Erebine Execution Manager (EEM). Homebrew installs all four on macOS and the last three on Linux. Each binary is also a direct download, and Linux gets Debian and RPM packages.

channel
releases/latest (stable)
platforms
macOS (Apple silicon), Linux (x86_64, aarch64)
homebrew
erebine/tap
license
MIT (Erebine components). Bundled third-party components are under their own licenses — see THIRD_PARTY_NOTICES, attached to every release of the binaries after v1.13.0.

What Ships

Static binaries are named <binary>-<OS>-<ARCH>, matching uname -s and uname -m on the target host, so a host can always fetch its own build. Linux builds are published for x86_64 and aarch64, macOS builds for arm64:

bash
curl -fLO "https://github.com/Erebine/binaries/releases/latest/download/erectl-$(uname -s)-$(uname -m)"
BinaryWhat it isLinuxmacOS
erectlCommand-line client for the API and platform managementx86_64, aarch64arm64
erebine-eimThe EIM: serves models on acceleratorsx86_64, aarch64arm64
erebine-eemThe EEM: runs tool and shell executions for workspacesx86_64, aarch64arm64

Earlier releases named these binaries erebine-eim-agent and erebine-eem-agent. Releases still publish each under its old name too, so existing scripts and download URLs keep working.

macOS

Releases also include macOS builds of erectl, erebine-eim and erebine-eem for Apple silicon, as <binary>-Darwin-arm64.

Homebrew

The erebine/tap tap carries the Erebine app as a cask and erectl, the EIM and the EEM as formulas. Add the tap and trust it, once:

bash
brew tap erebine/tap brew trust erebine/tap

Homebrew 6.0.0 and later load a cask or formula from a tap outside Homebrew only once the tap is trusted. Without brew trust, the installs below are refused.

Install the Erebine app:

bash
brew install --cask erebine-desktop

Install erectl, the EIM and the EEM:

bash
brew install erectl brew install erebine-eim brew install erebine-eem

Homebrew installs the zeromq and zstd libraries these binaries link against. Before v2.10.0 the EIM and EEM formulas were named erebine-eim-agent and erebine-eem-agent; both names still install the same formulas.

Linux

Linux binaries are published for x86_64 and aarch64. Homebrew and the static binaries cover both; the .deb and .rpm packages are built for x86_64.

Homebrew

Homebrew on Linux installs the same formulas as on macOS, on x86_64 and aarch64. The Erebine app cask is macOS only.

bash
brew tap erebine/tap brew trust erebine/tap brew install erectl brew install erebine-eim brew install erebine-eem

The formulas install the binaries alone. The systemd units for the EIM and EEM ship in the Debian and RPM packages.

Debian / Ubuntu (.deb)

Packages declare their library dependencies and install systemd units for the EIM and EEM. Download from Erebine/deb releases:

bash
sudo apt install -y ./erectl_*_amd64.deb sudo apt install -y ./erebine-eim-agent_*_amd64.deb ./erebine-eem-agent_*_amd64.deb

RHEL / Rocky / Fedora (.rpm)

The EIM and EEM packages depend on zeromq and libsodium, which ship in EPEL on RHEL and friends. Download from Erebine/rpm releases:

bash
sudo dnf install -y epel-release sudo dnf install -y ./erectl-*.x86_64.rpm sudo dnf install -y ./erebine-eim-agent-*.x86_64.rpm ./erebine-eem-agent-*.x86_64.rpm

For both package families the EIM and EEM install disabled: set the join key in /etc/erebine/eim-agent.env or /etc/erebine/eem-agent.env, then systemctl enable --now erebine-eim-agent (or erebine-eem-agent).

Static binaries

bash
curl -fLO "https://github.com/Erebine/binaries/releases/latest/download/erectl-Linux-$(uname -m)" chmod +x "erectl-Linux-$(uname -m)" sudo install "erectl-Linux-$(uname -m)" /usr/local/bin/erectl

uname -m reports x86_64 or aarch64; the same pattern works for erebine-eim-Linux-<ARCH> and erebine-eem-Linux-<ARCH>. Both architectures are built against glibc 2.34, so they run on RHEL 9, Debian 12, Ubuntu 22.04, Amazon Linux 2023, and anything newer. The binaries are statically linked against the Swift runtime; the EIM and EEM additionally need libzmq, libsodium, and libzstd from your distribution.

Containers

Prefer containers for GPU inference hosts. One EIM drives one accelerator or many, and several EIMs can share a machine, so you decide how your accelerators are split. Images and compose files live in Erebine/container-agents and are documented on the EIM Deployment page.

License

Erebine is MIT-licensed inference and execution runtimes, an open API, a proprietary control plane. The erectl client, the Erebine Inference Microservice (EIM) and the Erebine Execution Manager (EEM) are distributed as MIT-licensed binaries. The Erebine platform (router, control plane, frontend) is proprietary. Documentation and design papers are published under CC BY 4.0.

The MIT License grants no rights to the Erebine name or marks: redistribute the official binaries unmodified with the name intact, and rename a modified build. The trademark policy has the rules. These pages are under the documentation license.