Skip to main content

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.11/prek-installer.sh | sh

On Windows:

powershell -ExecutionPolicy ByPass -c "irm https://github.com/j178/prek/releases/download/v0.5.11/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.97+ 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@44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d # v3.1.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?

These projects use or recommend prek. Follow the links for adoption details.

Project Stars
Apache Airflow 47,116
Apache Iggy 5,044
ast-grep 16,140
attrs 5,853
Authlib 5,430
Cherry Studio 52,443
CocoIndex 11,651
CPython 77,561
devenv 7,721
FastAPI 102,873
FastMCP 28,011
Godot 118,258
Home Assistant 91,313
Kimi CLI (archived) 11,425
Matplotlib 23,341
msgspec 4,155
OpenClaw 391,637
paper-qa 9,329
PDM 8,664
Pendulum 6,677
Prowler 14,985
Pyodide 14,880
python-telegram-bot 29,515
RSSHub 46,449
Ruff 49,936
Sentry 45,507
Simple Icons 25,985
ty 19,817
Typer 20,056
UltraJSON 4,499

GitHub stars as of October 8, 2026. For more projects, see the GitHub dependents list.

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.

Metadata

Release files for prek 0.5.11

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.11
File Size Uploaded Provenance Actions
prek-0.5.11.tar.gz 619.4 kB With provenance Details for prek-0.5.11.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for prek 0.5.11
File Actions
prek-0.5.11-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for prek-0.5.11-py3-none-win_arm64.whl
prek-0.5.11-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for prek-0.5.11-py3-none-win_amd64.whl
prek-0.5.11-py3-none-musllinux_1_1_x86_64.whl Python 3 none Linux musl 1.1+ x86-64 Details for prek-0.5.11-py3-none-musllinux_1_1_x86_64.whl
prek-0.5.11-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details for prek-0.5.11-py3-none-manylinux_2_28_aarch64.whl
prek-0.5.11-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for prek-0.5.11-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
prek-0.5.11-py3-none-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for prek-0.5.11-py3-none-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl
prek-0.5.11-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64, Linux musl 1.1+ ARM64 Details for prek-0.5.11-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl
prek-0.5.11-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for prek-0.5.11-py3-none-macosx_11_0_arm64.whl
prek-0.5.11-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for prek-0.5.11-py3-none-macosx_10_12_x86_64.whl

Total release size: 52.8 MB

Release files / prek-0.5.11.tar.gz

Download URL prek-0.5.11.tar.gz
Size 619.4 kB
Tags Source
SHA-256 checksum
How to use checksums
99c8363ca07b881dc49cf71eb3c362670c95d0d554fc375ceee0245548081829
BLAKE2b-256 checksum
How to use checksums
190d8f661ef91334d8afe883a51f586628bb0a18c5077b39dc7c2754bc5335da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-win_arm64.whl
Size 5.5 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
e74faafdaf9512580c5d0fefa2891d5a092f92a4ff4e996cae6869922d830e32
BLAKE2b-256 checksum
How to use checksums
aed1e502bce18ae966dbf4c8a11ceb4157bde87da0bd0ee1d47bcecc0fe6cca0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-win_amd64.whl
Size 5.6 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
96503d57ea00e3f2b10942b340031396c7956b602ebb3719d090a401653800da
BLAKE2b-256 checksum
How to use checksums
06a588d4df7a4cd2d53626031beb3be69017b688a9e13828d0e8c6e1c1c3aae2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-musllinux_1_1_x86_64.whl
Size 6.1 MB
Tags Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
e5cbd96ed40c04a7909d98a9b8cd1d38e8e63d52e97932f09e1733b9f51bd6ac
BLAKE2b-256 checksum
How to use checksums
f2d60c8f2770bf03408e6c35ebea6e858d2f33d0e4037562a8f6092f73fd4223
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-manylinux_2_28_aarch64.whl
Size 5.7 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c90b274d8eb35f28d6b70907b9d757072e20dccde1bdb7d19eeb85aac9c37ee3
BLAKE2b-256 checksum
How to use checksums
f944a63b178a08d5bca1f4cfdef7305344195015fb6d5ff19be514b3a8a24f52
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 6.0 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
ca78936abfb2793ba9d6b9b4ac0e4eb13189bcfabd16d94c29aa573963bac87f
BLAKE2b-256 checksum
How to use checksums
02f035e94ecd6eab935705e68cfb33af06d27db4693a49214171a9adfcecb756
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / prek-0.5.11-py3-none-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl

Download URL prek-0.5.11-py3-none-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl
Size 6.1 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
c343b4e40e5aa5851fd0526c49ad8f52c4c688cde848fa95f57db91c15c67215
BLAKE2b-256 checksum
How to use checksums
192596988fbaf7bb960028fc4161ed734d0950bfda720c37206b3c6d07e044c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl
Size 5.7 MB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum
How to use checksums
1cce91fe6524e1b2dfc4e5f40353caa0b62e2db9ae4b2bab314958027663a712
BLAKE2b-256 checksum
How to use checksums
155357e487d315e1fe7b1b11b1df01233f3c9cda14502f61ba76c34991d80358
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-macosx_11_0_arm64.whl
Size 5.6 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
2e530bd4c8975c6ac6eae20c70fa54c50714d56279040cc3c2b0bce279c0c84e
BLAKE2b-256 checksum
How to use checksums
ad24ef97844954e5a89c79de675d22fad0aa549db21c32226dde4a12eef5da6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

Download URL prek-0.5.11-py3-none-macosx_10_12_x86_64.whl
Size 5.9 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
95da482d8f1d3323beea219e95b6bbe31a27d3b14943148d3c4eac94e9f7d7ee
BLAKE2b-256 checksum
How to use checksums
2633b56b4898fe9a81e250d31e39cce0ae5705ee07609aa5f013cd22cfd781bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for prek 0.5.11

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 10 files in this release have been uploaded with provenance metadata.

Select from 10 files

Attestation for prek-0.5.11.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.11 This release

10 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page