pypa-hatch/docs/index.md

Hatch

{ role="img" }

CI/CD	{ loading=lazy .off-glb } { loading=lazy .off-glb } { loading=lazy .off-glb }
Docs	{ loading=lazy .off-glb } { loading=lazy .off-glb }
Package	{ loading=lazy .off-glb } { loading=lazy .off-glb } { loading=lazy .off-glb } { loading=lazy .off-glb }
Meta	{ loading=lazy .off-glb } { loading=lazy .off-glb } { loading=lazy .off-glb } { loading=lazy .off-glb } { loading=lazy .off-glb }

---

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

• :material-hammer-wrench:{ .lg .middle } Build system

  ---

  Reproducible builds by default with a rich ecosystem of plugins

  :octicons-arrow-right-24: Configure builds

• :material-lock:{ .lg .middle } Environments

  ---

  Robust environment management with support for custom scripts and UV

  :octicons-arrow-right-24: Getting started

• :material-language-python:{ .lg .middle } Python management

  ---

  Choose between easy manual installations or automatic as part of environments

  :octicons-arrow-right-24: Try it

• :octicons-shield-check-24:{ .lg .middle } Testing

  ---

  Test execution with known best practices

  :octicons-arrow-right-24: Run

• :material-magnify-scan:{ .lg .middle } Static analysis

  ---

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

  :octicons-arrow-right-24: Learn

• :material-console-line:{ .lg .middle } Script runner

  ---

  Execute Python scripts with specific dependencies and Python versions

  :octicons-arrow-right-24: Execute

• :material-publish:{ .lg .middle } Publishing

  ---

  Easily upload to PyPI or other indices

  :octicons-arrow-right-24: See how

• :octicons-number-24:{ .lg .middle } Versioning

  ---

  Streamlined workflow for bumping versions

  :octicons-arrow-right-24: Managing versions

• :octicons-project-template-24:{ .lg .middle } Project generation

  ---

  Create new projects from templates with known best practices

  :octicons-arrow-right-24: Project setup

• :material-speedometer:{ .lg .middle } Responsive CLI

  ---

  Hatch is up to 3x faster than equivalent tools

  :octicons-arrow-right-24: CLI reference

License

Hatch is distributed under the terms of the MIT license.

Navigation

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