Skip to content


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


  • Static analysis

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


  • Script runner

    Execute Python scripts with specific dependencies and Python versions


  • 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


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