Install¶

Four install paths. Most people should use Homebrew (path 1). The others are for specific situations — minimal installs, Python-only workflows, or containerized runs.

1. Homebrew (macOS or Linux) — recommended¶

brew tap llamaclaw/tap https://github.com/llamaclaw/installer.git
brew install esml

Add-ons under the same tap:

brew install --HEAD llamaclaw/tap/tide      # Go TUI
brew install --HEAD llamaclaw/tap/kronos    # Rust ARM terminal multiplexer

2. curl | bash (any POSIX system)¶

curl -fsSL https://install.llamaclaw.org | bash

Flags:

--minimal — skip R
--with-pi — also install Perseus Ollama model + wire systemd units

Always inspect before piping:

curl -fsSL https://install.llamaclaw.org | less

3. pip (Python-only)¶

pip install git+https://github.com/llamaclaw/esml.git@v0.2.0

Requires Python 3.10+. System deps: gfortran, libopenblas-dev, pkg-config.

For editable dev install:

git clone git@github.com:llamaclaw/esml.git
cd esml && pip install -e ".[test]"

4. Docker¶

docker pull ghcr.io/llamaclaw/esml:latest
docker run --rm -it ghcr.io/llamaclaw/esml esml list-datasets

Multi-arch images for linux/amd64 and linux/arm64. Companion images:

docker pull ghcr.io/llamaclaw/tide:latest     # TUI
docker pull ghcr.io/llamaclaw/kronos:latest   # ARM64 multiplexer

Pi bootstrap (16 GB RAM + NVMe)¶

curl -fsSL https://install.llamaclaw.org | bash -s -- --with-pi

That runs the full Pi setup: ESML + R + Ollama + Perseus model + systemd units from llamaclaw/deploy. Uses ~10 GB disk.

Verify¶

esml --version
esml list-datasets    # 41 datasets
esml list-modules     # 23 analysis modules
esml doctor           # environment diagnostics

Uninstall¶

brew uninstall esml                        # if Homebrew
pip uninstall esml turboquant perseus      # if pip
docker rmi ghcr.io/llamaclaw/esml:latest   # if Docker