Installation

Homebrew macOS + Linux binaries OCI image

Homebrew

Use the fully qualified formula name. Homebrew installs the current Hoplite release and trusts only the Greenways tap entry you selected.

brew install greenways-ai/tap/hoplite
hoplite version

Install script

On macOS or Linux, install the published binary without a package manager:

curl -fsSL https://raw.githubusercontent.com/greenways-ai/hoplite/main/scripts/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
hoplite version

Set HOPLITE_INSTALL_DIR to choose another destination:

curl -fsSL https://raw.githubusercontent.com/greenways-ai/hoplite/main/scripts/install.sh \
  | HOPLITE_INSTALL_DIR=/usr/local/bin sh

Create the starter application

The starter script writes a minimal app.hal and project.edn; it does not clone or build Hoplite.

curl -fsSL https://raw.githubusercontent.com/greenways-ai/hoplite/main/scripts/new-app.sh | sh -s -- hello
cd hello
hoplite serve foreground --mode prod .

In another terminal:

curl -i http://127.0.0.1:8080/hello

Run the published container

docker run --rm -p 8080:8080 ghcr.io/greenways-ai/hoplite:latest
curl -i http://127.0.0.1:8080/hello

Platform support

Platform	Status	Distribution
macOS arm64	Supported	Homebrew and standalone binary
macOS Intel	Supported	Homebrew and standalone binary
Linux arm64	Supported	Homebrew, installer, binary, and OCI image
Linux x86-64	Supported	Homebrew, installer, binary, and OCI image
Windows	Unsupported	No supported host lifecycle integration