Installation

Hoard requires Python 3.11 or newer. Choose your preferred installation method below.

Installation Methods

pipx (Recommended)

pipx install hoard

pipx installs Hoard in an isolated environment while making the hoard command available globally. This is the recommended method.

If you don’t have pipx:

brew install pipx
pipx ensurepath

Homebrew

brew install hoard

Homebrew handles Python dependencies automatically.

pip

python3.11 -m pip install hoard

Caution

Make sure you’re using Python 3.11+. Check with python3 --version.

From Source

git clone https://github.com/thrr87/hoard
cd hoard
pip install -e .

Verify Installation

After installation, verify Hoard is working:

hoard --version

You should see the version number displayed.

Optional: Vector Search

To enable semantic (vector) search, install the vectors extra:

pip install hoard[vectors]

This downloads the embedding model (~90MB) on first use. Vector search is optional — Hoard works great with just keyword (BM25) search.

Python Version Issues

If you see an error about Python version:

ERROR: Package 'hoard' requires a different Python: 3.9.6 not in '>=3.11'

Solutions:

1. Use pipx — It manages Python versions automatically
2. Install Python 3.11+:

   brew install python@3.11
   python3.11 -m pip install hoard

Next Steps

Once installed, run the setup wizard:

hoard init

This will guide you through configuring your data sources and connecting AI tools.

Continue to Quick Start →