Installation¶

Hector is distributed as a single binary with no runtime dependencies. Choose your preferred installation method below.

Requirements¶

Go 1.24+ (for go install method only)
Linux, macOS, or Windows (amd64 or arm64)

Go Install (Recommended)¶

Install the latest version directly from source:

go install github.com/verikod/hector/cmd/hector@latest

Verify installation:

hector version

Binary Download¶

Download pre-built binaries from GitHub Releases:

Linux (amd64)¶

curl -LO https://github.com/verikod/hector/releases/latest/download/hector_linux_amd64.tar.gz
tar -xzf hector_linux_amd64.tar.gz
sudo mv hector /usr/local/bin/

Linux (arm64)¶

curl -LO https://github.com/verikod/hector/releases/latest/download/hector_linux_arm64.tar.gz
tar -xzf hector_linux_arm64.tar.gz
sudo mv hector /usr/local/bin/

macOS (Intel)¶

curl -LO https://github.com/verikod/hector/releases/latest/download/hector_darwin_amd64.tar.gz
tar -xzf hector_darwin_amd64.tar.gz
sudo mv hector /usr/local/bin/

macOS (Apple Silicon)¶

curl -LO https://github.com/verikod/hector/releases/latest/download/hector_darwin_arm64.tar.gz
tar -xzf hector_darwin_arm64.tar.gz
sudo mv hector /usr/local/bin/

Windows¶

Download hector_windows_amd64.zip from the releases page, extract it, and add the directory to your PATH.

Docker¶

Run Hector in a container:

docker pull ghcr.io/verikod/hector:latest
docker run -p 8080:8080 -e OPENAI_API_KEY=your-key ghcr.io/verikod/hector:latest

Or build locally:

git clone https://github.com/verikod/hector.git
cd hector
docker build -t hector .
docker run -p 8080:8080 -e OPENAI_API_KEY=your-key hector

Build from Source¶

Clone and build:

git clone https://github.com/verikod/hector.git
cd hector
make build
./bin/hector version

Install to system:

make install

Verify Installation¶

Check that Hector is correctly installed:

$ hector version
Hector version dev

View available commands:

$ hector --help