Installation

Choose your method

Method	Startup	Requires Python	Isolation	Best for
pipx	~100 ms ⚡	Yes (3.12+)	Full (auto-managed venv)	Daily use, best performance
Native binary	~290 ms	No	Full (self-contained)	Quick start, CI runners, no Python available
pip	~100 ms ⚡	Yes (3.12+)	Manual (use a venv)	Integrating into Python projects

TL;DR — Have Python? Use pipx (3× faster startup). No Python? Grab the native binary.

---

pipx (recommended if you have Python)

pipx installs in an isolated environment and manages PATH automatically — no virtualenv needed:

pipx install hac-client-cli

Installing pipx

Linux / macOS

# Ubuntu / Debian
sudo apt install pipx
pipx ensurepath

# macOS
brew install pipx
pipx ensurepath

Windows

# Requires Python 3.12+ and pip
pip install --user pipx
pipx ensurepath

If you don't have Python yet, install it from python.org or via winget:

winget install Python.Python.3.12

Then restart your terminal and run the pip install --user pipx command above.

---

Native executable (zero dependencies)

Download the latest release for your platform from GitHub Releases.

Linux (x86_64)

curl -Lo hac https://github.com/SapCommerceTools/hac-client-cli/releases/latest/download/hac-linux-x86_64
chmod +x hac
sudo mv hac /usr/local/bin/
hac --help

macOS (Apple Silicon)

curl -Lo hac https://github.com/SapCommerceTools/hac-client-cli/releases/latest/download/hac-macos-arm64
xattr -d com.apple.quarantine hac 2>/dev/null
chmod +x hac
sudo mv hac /usr/local/bin/
hac --help

macOS (Intel)

curl -Lo hac https://github.com/SapCommerceTools/hac-client-cli/releases/latest/download/hac-macos-x86_64
xattr -d com.apple.quarantine hac 2>/dev/null
chmod +x hac
sudo mv hac /usr/local/bin/
hac --help

Windows (x86_64)

1. Download hac-windows-x86_64.exe from the latest release.
2. Rename to hac.exe (optional).
3. Move to a directory on your PATH, or add the download directory to PATH.

PowerShell one-liner:

Invoke-WebRequest -Uri "https://github.com/SapCommerceTools/hac-client-cli/releases/latest/download/hac-windows-x86_64.exe" -OutFile "$env:LOCALAPPDATA\hac.exe"

---

pip (requires Python 3.12+)

pip install hac-client-cli

Or install from source:

git clone https://github.com/SapCommerceTools/hac-client-cli.git
cd hac-client-cli
pip install -e .

---

Verify installation

hac --help

You should see:

Usage: hac [OPTIONS] COMMAND [ARGS]...

SAP Commerce HAC client

Commands:
  config      Discover, inspect, and manage configuration
  endpoint    Manage HAC endpoints
  env         Manage HAC environments
  flexsearch  Execute FlexibleSearch query
  groovy      Execute Groovy script
  impex       Import Impex data
  session     Manage HAC sessions
  update      System update and initialization