Skip to content

Hatch

Hatch logo

CI/CD CI - Test CD - Build Hatch CD - Build Hatchling
Docs Docs - Release Docs - Dev
Package PyPI - Version PyPI - Python Version PyPI - Installs Release - Downloads
Meta Hatch project linting - Ruff types - Mypy License - MIT GitHub Sponsors

Hatch is a modern, extensible Python project manager. See the Why Hatch? page for more information.

  • Build system


    Reproducible builds by default with a rich ecosystem of plugins

    Configure builds

  • Environments


    Robust environment management with support for custom scripts and UV

    Getting started

  • Python management


    Choose between easy manual installations or automatic as part of environments

    Try it

  • Testing


    Test execution with known best practices

    Run

  • Static analysis


    Static analysis backed by Ruff with up-to-date, sane defaults

    Learn

  • Script runner


    Execute Python scripts with specific dependencies and Python versions

    Execute

  • Publishing


    Easily upload to PyPI or other indices

    See how

  • Versioning


    Streamlined workflow for bumping versions

    Managing versions

  • Project generation


    Create new projects from templates with known best practices

    Project setup

  • Responsive CLI


    Hatch is up to 3x faster than equivalent tools

    CLI reference

License

Hatch is distributed under the terms of the MIT license.

Documentation for specific MAJOR.MINOR versions can be chosen by using the dropdown on the top of every page. The dev version reflects changes that have not yet been released.

Also, desktop readers can use special keyboard shortcuts:

Keys Action
  • , (comma)
  • p
Navigate to the "previous" page
  • . (period)
  • n
Navigate to the "next" page
  • /
  • s
Display the search modal