prek/docs/installation.md

Installation

prek provides multiple installation methods to suit different needs and environments.

Standalone Installer

The standalone installer automatically downloads and installs the correct binary for your platform:

Linux and macOS

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.2.0-alpha.2/prek-installer.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://github.com/j178/prek/releases/download/v0.2.0-alpha.2/prek-installer.ps1 | iex"

Package Managers

PyPI

Install via pip, uv (recommended), or pipx:

# Using uv (recommended)
uv tool install prek

# Using pip
pip install prek

# Using pipx
pipx install prek

Homebrew (macOS/Linux)

brew install prek

mise (Cross-platform)

mise use prek

Build from Source

Using Cargo

cargo install --locked --git https://github.com/j178/prek

Download from GitHub Releases

Pre-built binaries are available for download from the GitHub releases page.

Updating

If you installed via the standalone installer, you can update to the latest version:

prek self update

For other installation methods, follow the same installation steps again.

Shell Completion

prek supports shell completion for Bash, Zsh, Fish, and PowerShell. To install completions:

Bash

COMPLETE=bash prek > /etc/bash_completion.d/prek

Zsh

COMPLETE=zsh prek completion > "${fpath[1]}/_prek"

Fish

COMPLETE=fish prek > ~/.config/fish/completions/prek.fish

PowerShell

COMPLETE=powershell prek >> $PROFILE