Installation

Prerequisites

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

Quick Install (Recommended)

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

Or download directly from Releases.

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/

Install Ollama (Recommended)

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

Keep grepai up to date with the built-in update command:

# 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

• Quick Start - Initialize and start using grepai
• Configuration - Configure embedders and storage backends