prek · PyPI

Installation • Quick start • Documentation

About

prek is a framework for running hooks on your code. It runs them before you commit changes, on demand, or in CI. These hooks can format files, catch lint errors, detect secrets, or run any other command your project defines. prek also installs and manages the tools and dependencies they need.

You may already be familiar with the pre-commit tool. prek is a reimagined version of it, built in Rust. It is faster and distributed as a single binary with no runtime dependencies. It is fully compatible with pre-commit configurations and hooks, so you can use it as a drop-in replacement without changing your setup.

Although prek is pretty new, it’s already powering real‑world projects like CPython, Apache Airflow, FastAPI, and more projects are picking it up—see Who is using prek?. If you’re looking for an alternative to pre-commit, please give it a try—we’d love your feedback!

Features

A single binary with no dependencies, does not require Python or any other runtime.
Faster than pre-commit and more efficient in disk space usage.
Fully compatible with the original pre-commit configurations and hooks.
Built-in support for monorepos (i.e. workspace mode), including concurrent execution for independent same-depth projects.
Integration with uv for managing Python virtual environments and dependencies.
Improved toolchain installations for Python, Node.js, Bun, Go, Rust and Ruby, shared between hooks.
Built-in Rust-native implementation of some common hooks.

Installation

Standalone installer

prek provides a standalone installer script to download and install the tool,

On Linux and macOS:

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

On Windows:

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

PyPI

prek is published as Python binary wheel to PyPI, you can install it using pip, uv (recommended), or pipx:

# Using uv (recommended)
uv tool install prek

# Using uvx (install and run in one command)
uvx prek

# Adding prek to the project dev-dependencies
uv add --dev prek

# Using pip
pip install prek

# Using pipx
pipx install prek

Homebrew

brew install prek

mise

To use prek with mise (v2025.8.11 or later):

mise use prek

Cargo binstall

Install pre-compiled binaries from GitHub using cargo-binstall:

cargo binstall prek

Cargo

Build from source using Cargo (Rust 1.96+ is required):

cargo install --locked prek

npmjs

prek is published as a Node.js package and can be installed with any npm-compatible package manager:

# As a dev dependency
npm add -D @j178/prek
pnpm add -D @j178/prek
bun add -D @j178/prek

# Or install globally
npm install -g @j178/prek
pnpm add -g @j178/prek
bun install -g @j178/prek

# Or run directly without installing
npx @j178/prek --version
bunx @j178/prek --version

Nix

prek is available via Nixpkgs.

# Choose what's appropriate for your use case.
# One-off in a shell:
nix-shell -p prek

# NixOS or non-NixOS without flakes:
nix-env -iA nixos.prek

# Non-NixOS with flakes:
nix profile install nixpkgs#prek

Conda

prek is available as prek via conda-forge.

conda install conda-forge::prek

Scoop (Windows)

prek is available via Scoop.

scoop install main/prek

Winget (Windows)

prek is available via winget.

winget install --id j178.Prek

MacPorts

prek is available via MacPorts.

sudo port install prek

GitHub Releases

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

GitHub Actions

prek can be used in GitHub Actions via the j178/prek-action repository.

Example workflow:

name: Prek checks
on: [push, pull_request]

jobs:
  prek:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
      - uses: j178/prek-action@4e14d07f9231acabce116ccfca13b13dd9755ece # v3.0.0

This action installs prek and runs prek run --all-files on your repository.

prek is also available via taiki-e/install-action for installing various tools.

prek skill for agents

To let agents use prek, install the prek skill with gh skill (v2.90.0+):

gh skill install j178/prek prek

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

prek self update

Quick start

I already use pre-commit: follow the short migration checklist in the quickstart guide to swap in prek safely.
I'm new to pre-commit-style tools: learn the basics—creating a config, running hooks, and installing Git shims—in the beginner quickstart walkthrough.

Why prek?

prek is faster

It is multiple times faster than pre-commit while also using less disk space.
Hook environments and toolchains are shared across hooks instead of being duplicated per repository, which reduces both install time and cache size.
Repository fetches and independent hook environment setup run in parallel, hooks can run concurrently by priority using reusable aliases, and independent workspace projects at the same directory depth can run concurrently.
It uses uv for creating Python virtualenvs and installing dependencies, which is known for its speed and efficiency.
For supported hooks from pre-commit-hooks, the automatic fast path runs built-in Rust implementations without requiring any configuration changes.
The prek-only repo: builtin mode provides offline, zero-setup hooks, including native deny-pattern and require-pattern alternatives for common pygrep checks.

prek is easier to work with

No need to install Python or any other runtime just to use prek; it is a single binary.
Its language support covers every language available in pre-commit, plus Bun, Deno, mise, and PHP, and it automatically installs managed toolchains when needed for Python, Node.js, Bun, Deno, Go, mise, Rust, and Ruby.
It supports native prek.toml in addition to pre-commit YAML, and prek util yaml-to-toml helps migrate existing configs.
Built-in support for workspaces means monorepos can keep separate configs per project and still run everything from one command, while independent same-depth projects run concurrently without mixing file scopes.
prek install and prek uninstall honor repo-local and worktree-local core.hooksPath.
Hook groups let one config define workflows such as CI, linting, or formatting; --group, --require-group, and --no-group select them at runtime.
prek run can select or skip multiple projects and hooks, target tracked files with repeatable --glob or --directory filters, pass explicit paths with --files, and preview the selection with --dry-run.
The progress UI streams a live preview from running hooks, so long-running checks do not look stuck and failures are easier to diagnose.
prek list, prek util identify, and prek util list-builtins -v make it easier to inspect configured hooks, debug file matching, and discover builtins with their supported options.

prek includes security-focused safeguards

For supported managed toolchain downloads, prek verifies the downloaded archive or installer checksum before extracting or installing it, helping ensure the integrity of downloaded toolchains.
prek update can keep newly published releases on hold with --cooldown-days, filter eligible tags with glob patterns, and freeze revisions to commit SHAs.
prek update validates pinned SHA revisions against the fetched upstream refs, including impostor-commit detection, and keeps # frozen: comments in sync with the configured commit.
prek update --check is useful in CI when you want updates or frozen-reference mismatches to fail the job without rewriting the config.

For more detailed improvements prek offers, take a look at Difference from pre-commit.

Who is using prek?

prek is pretty new, but it is already being used or recommended by some projects and organizations. GitHub stars are current as of April 15, 2026.

apache/airflow _{45,050 stars}
apache/iggy _{4,116 stars}
apache/lucene _{3,401 stars}
ast-grep/ast-grep _{13,413 stars}
astral-sh/ruff _{47,070 stars}
astral-sh/ty _{18,308 stars}
authlib/authlib _{5,271 stars}
cachix/devenv _{6,665 stars}
cocoindex-io/cocoindex _{6,865 stars}
commitizen-tools/commitizen _{3,377 stars}
DetachHead/basedpyright _{3,267 stars}
django/djangoproject.com _{1,994 stars}
fastapi/asyncer _{2,407 stars}
fastapi/fastapi _{97,209 stars}
fastapi/typer _{19,210 stars}
Future-House/paper-qa _{8,377 stars}
getsentry/sentry _{43,639 stars}
godotengine/godot _{110,312 stars}
home-assistant/core _{86,029 stars}
jcrist/msgspec _{3,692 stars}
jlowin/fastmcp _{24,539 stars}
MoonshotAI/kimi-cli _{7,800 stars}
openclaw/openclaw _{357,512 stars}
OpenLineage/OpenLineage _{2,406 stars}
pdm-project/pdm _{8,553 stars}
prowler-cloud/prowler _{13,592 stars}
pyodide/pyodide _{14,527 stars}
python-attrs/attrs _{5,770 stars}
python-telegram-bot/python-telegram-bot _{29,025 stars}
python/cpython _{72,330 stars}
simple-icons/simple-icons _{24,873 stars}

For a more comprehensive list of open-source projects using prek see the list of dependents on github.

Acknowledgements

This project is heavily inspired by the original pre-commit tool, and it wouldn't be possible without the hard work of the maintainers and contributors of that project.

And a special thanks to the Astral team for their remarkable projects, particularly uv, from which I've learned a lot on how to write efficient and idiomatic Rust code.

Development Status
- 5 - Production/Stable
Environment
- Console
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
- Rust
Topic
- Software Development :: Quality Assurance

Release files for prek 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for prek 0.5.2
File	Size	Uploaded
prek-0.5.2.tar.gz	549.4 kB	Sep 2, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for prek 0.5.2
File	Interpreter	ABI	Platform	Reset
prek-0.5.2-py3-none-win_arm64.whl 5.5 MB Sep 2, 2026	Python 3	none	Windows ARM64	Details
prek-0.5.2-py3-none-win_amd64.whl 5.7 MB Sep 2, 2026	Python 3	none	Windows x86-64	Details
prek-0.5.2-py3-none-musllinux_1_1_x86_64.whl 6.3 MB Sep 2, 2026	Python 3	none	Linux musl 1.1+ x86-64	Details
prek-0.5.2-py3-none-manylinux_2_28_aarch64.whl 5.8 MB Sep 2, 2026	Python 3	none	Linux glibc 2.28+ ARM64	Details
prek-0.5.2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 6.2 MB Sep 2, 2026	Python 3	none	Linux glibc 2.17+ x86-64	Details
prek-0.5.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl 5.8 MB Sep 2, 2026	Python 3	none	Linux glibc 2.17+ ARM64, Linux musl 1.1+ ARM64	Details
prek-0.5.2-py3-none-macosx_11_0_arm64.whl 5.5 MB Sep 2, 2026	Python 3	none	macOS 11.0+ ARM64	Details
prek-0.5.2-py3-none-macosx_10_12_x86_64.whl 6.0 MB Sep 2, 2026	Python 3	none	macOS 10.12+ x86-64	Details

Total release size: 47.5 MB

Release files / prek-0.5.2.tar.gz

Download URL	prek-0.5.2.tar.gz
Size	549.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`a90ea4eeba35c6081bad29775f6a49fcc33fb80372424fce64c7a9c5774e8204`
BLAKE2b-256 checksum How to use checksums	`b1054402641f168dd862d27592cbd4c5fb171d119c15611e5dbef3df857e8932`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-win_arm64.whl

Download URL	prek-0.5.2-py3-none-win_arm64.whl
Size	5.5 MB
Tags	Python 3 Windows ARM64
SHA-256 checksum How to use checksums	`0ebea4ef39f6446f6c414a5a506cde8942b17b5899f74cf90e352628085d4005`
BLAKE2b-256 checksum How to use checksums	`df7c409ced8866197da50e9bcb2c9bf101e3e9a35b98a851c0ccd2a44509eaa5`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-win_amd64.whl

Download URL	prek-0.5.2-py3-none-win_amd64.whl
Size	5.7 MB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`b6c0e4f272f9410f8218d1db0cc7ea10cd8f62db19f820b9ace9f6c2b33bd8dd`
BLAKE2b-256 checksum How to use checksums	`8ff84aefbf76dae091078655fbaf065c34fa900d43b39c2b88e80cbaa71b5efb`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-musllinux_1_1_x86_64.whl

Download URL	prek-0.5.2-py3-none-musllinux_1_1_x86_64.whl
Size	6.3 MB
Tags	Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum How to use checksums	`86aebcd8ab831036fc3ac9b15275412403e21041da031e6c9f1547888843e5c6`
BLAKE2b-256 checksum How to use checksums	`4471c798d54741cc8f345b211e453dda9599546fb213c3593eb711cb6c710bbf`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-manylinux_2_28_aarch64.whl

Download URL	prek-0.5.2-py3-none-manylinux_2_28_aarch64.whl
Size	5.8 MB
Tags	Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum How to use checksums	`1d52de8428d5eef7c8c0fd64efd7d31210d13924fd36a02975d462675715aeb7`
BLAKE2b-256 checksum How to use checksums	`f6fb2e5f8adbee718f15333a113872104c4b3d25ecce423dd7117cfcd28a25fe`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	prek-0.5.2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	6.2 MB
Tags	Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum How to use checksums	`a0e22f11c1fb5df89acf5cbde78f6139edf2c30a205bea5a5d4a094366dcdbda`
BLAKE2b-256 checksum How to use checksums	`1ebda4a5a3022915b8e1768df9b2d8744f3e7c4b3bb7cdbe697612cc96054169`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl

Download URL	prek-0.5.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Size	5.8 MB
Tags	Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum How to use checksums	`c0219d1e694a962e3b3ae98f42f53065d2e2856719caee88578d24b35ea74cad`
BLAKE2b-256 checksum How to use checksums	`3b19be25a56ab243f2e5c9333c38bad33bddffec92ea8a25e34248eba6e00ac8`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-macosx_11_0_arm64.whl

Download URL	prek-0.5.2-py3-none-macosx_11_0_arm64.whl
Size	5.5 MB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`0eb3b812fc13bc5c05cfc1a8b469f9665a02f845753c3759ad7aca50af707afb`
BLAKE2b-256 checksum How to use checksums	`cbd99772fd4d4023c34780d957f407d9437e2a16d6bef77e3da9fa4374cd75bb`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / prek-0.5.2-py3-none-macosx_10_12_x86_64.whl

Download URL	prek-0.5.2-py3-none-macosx_10_12_x86_64.whl
Size	6.0 MB
Tags	Python 3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`40d488a48de3f47f48bd4911ee5dec25e615f992b4cde821e9b50d40c615b39e`
BLAKE2b-256 checksum How to use checksums	`6e25cf9c6064fea82ba6f4801dc3be650cc86eae3d9951e2a6fb28b21cbfa156`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`