grepai

Installation

How to install grepai

Prerequisites

  • Ollama (for local embeddings) or an OpenAI API key (for cloud embeddings)

Homebrew (macOS)

The easiest way to install grepai on macOS:

brew install yoanbernabeu/tap/grepai

To upgrade later:

brew upgrade grepai

Shell Script (Linux/macOS)

Recommended for Linux, alternative for macOS:

curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh

Or download directly from Releases.

Windows (PowerShell)

Run the following command in your PowerShell terminal:

irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex

Install from Source

Requires Go 1.24+.

# Clone the repository
git clone https://github.com/yoanbernabeu/grepai.git
cd grepai

# Build the binary
make build

# The binary is created at ./bin/grepai
# Move it to your PATH
sudo mv ./bin/grepai /usr/local/bin/

For privacy-first local embeddings, install Ollama:

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Start Ollama
ollama serve

# Pull the embedding model
ollama pull nomic-embed-text

Verify Installation

# Check grepai is installed
grepai version

# Check Ollama is running (if using local embeddings)
curl http://localhost:11434/api/tags

Updating

If installed via Homebrew:

brew upgrade grepai

If installed via shell script or binary:

# Check for available updates
grepai update --check

# Download and install the latest version
grepai update

The update command will:

  • Fetch the latest release from GitHub
  • Download the appropriate binary for your platform
  • Verify checksum integrity
  • Replace the current binary automatically

Next Steps