# Install hatch with Homebrew, apk, dnf, MacPorts, Nix, scoop, winget Modern, extensible Python project management. Version 1.17.1 via Homebrew; verified 2026-07-09. ## Install ```sh sudo av install brew:hatch ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hatch ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install hatch ``` Evidence: MacPorts ports tree: python/hatch/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add hatch ``` Evidence: Alpine Linux edge package indexes: hatch from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - dnf (92%): ```sh sudo dnf install hatch ``` Evidence: Fedora Rawhide package metadata: hatch from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#hatch ``` Evidence: nixpkgs package indexes: pkgs/by-name/ha/hatch/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install main/hatch ``` Evidence: Scoop official bucket manifest trees: bucket/hatch.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id PyPA.Hatch -e ``` Evidence: Windows Package Manager source index: PyPA.Hatch from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:hatch - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.17.1 - **Source summary:** Modern, extensible Python project management - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-09T03:33:21Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - hatch (cli) - hatch (alias) ## Dependencies - certifi - cryptography - python@3.14 - uv ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 1.17.1 - Package-manager updated: 2026-07-09 - Local data: ok - Upstream repository: https://hatch.pypa.io/latest/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Hatch is a modern, extensible Python project manager under the PyPA organization. It packages project creation, build backend integration, environment management, testing, static analysis, versioning, publishing, Python distribution management, and script running behind one CLI. Its history is tied to Python's move toward pyproject.toml-centered packaging. Hatch and Hatchling give package authors a standards-compliant build backend plus a workflow tool, making it a notable entry in the post-setup.py packaging era. ### Project history The Hatch history page records version 1.0.0 on 2022-04-28 as the first stable release of Hatch v1 and a complete rewrite. The adjacent Hatchling history records 0.24.0 on the same date as the initial public release of the Hatchling build system, establishing the split between the user-facing Hatch CLI and the build backend. The 1.1.0 history entry says project metadata was updated to reflect adoption by PyPA and production stability. That matters historically because PyPA ownership placed Hatch among the packaging tools documented and maintained in the Python packaging ecosystem rather than as only an individual project. Later history entries show Hatch broadening from packaging and environments into batteries-included project operations: publishing confirmation and index plugins, virtual-environment storage and plugin APIs, automatic Python distribution downloads, test commands, static analysis defaults, standalone binaries through PyApp, UV support, dependency groups, workspaces, and PEP 751 lockfile commands. ### Adoption history Hatch adoption came from Python projects that wanted a single pyproject.toml-native workflow for building, testing, versioning, environment scripts, and publishing. Its README presents standardized builds, reproducible builds by default, environment management, Python management, test execution, static analysis, script running, publishing, version management, and project generation as first-class features. The build documentation emphasizes that Hatch complies with modern Python packaging specifications and that other tools can consume projects using Hatch as a build backend. This is central to adoption: projects can use Hatchling while still interoperating with pip, tox, cibuildwheel, PyPI, and other packaging tools. Package-manager adoption reflects that dual role. Homebrew and other OS package managers distribute the hatch CLI, while Python packaging itself consumes Hatchling through build-system requirements in pyproject.toml. ### How it is used Typical CLI workflows include hatch new, hatch build, hatch publish, hatch version, hatch run, hatch env commands, hatch test, and Hatch-managed Python or environment operations. Configuration lives in user config files plus pyproject.toml or hatch.toml project tables. As a build backend, Hatchling is declared in pyproject.toml with build-system.requires and build-backend. As a workflow manager, Hatch creates and runs named environments, executes scripts, builds distributions, and coordinates publishing without forcing all projects to abandon other tools in the packaging ecosystem. ### Why package nerds care Hatch is significant because it bundles several trends in Python packaging: pyproject.toml configuration, backend/front-end separation, reproducible builds, environment automation, plugin hooks, and standards-based metadata. It is not just a build backend and not just a virtualenv wrapper. For package nerds, Hatchling's small build-backend role is as important as the hatch CLI. A project can depend on Hatchling for wheel and sdist creation while developers use Hatch for environments, scripts, tests, versions, and publishing. The changelog also tracks the moving Python packaging target: Python version support drops, metadata version updates, SBOM support, dependency groups, UV integration, lockfiles, PyPI telemetry user agents, and workspace concepts all appear as the ecosystem evolves. ### Timeline - 2022-04-28: Hatch 1.0.0 shipped as the first stable v1 release and complete rewrite; Hatchling 0.24.0 shipped as the initial public build-system release. - 2022-05-12: Hatch 1.1.0 updated project metadata to reflect PyPA adoption and production stability. - 2023: Hatch added and refined publishing, virtual environment behavior, build backend flexibility, automatic Python downloads, and plugin interfaces. - 2024: Hatch added a test command, UV support for virtual environments, official GitHub Action support, and Python distribution source controls. - 2025: Hatch 1.16.0 added workspace support inspired by Cargo Workspaces and dependency group support. - 2026: Hatch 1.17.0 added check commands, PEP 751 lockfile generation, dependency lock/sync commands, and pluggable dependency lockers. ### Related projects - Hatchling is Hatch's build backend and is declared by projects through pyproject.toml. - PyPA is the Python Packaging Authority organization under which Hatch is maintained. - PyPI, pip, tox, cibuildwheel, virtualenv, UV, Ruff, PyApp, and Python packaging standards are recurring integration points in Hatch documentation and history. ### Sources - - - - - - - ## Security Notes No matching local secret-handling manifest was found for hatch. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - macOS: ~/Library/Application Support/hatch/config.toml - Unix: $XDG_CONFIG_HOME/hatch/config.toml, ~/.config/hatch/config.toml - Windows: %USERPROFILE%\AppData\Local\hatch\config.toml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hatch - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - hatch: normalized package name match | nixpkgs package indexes: pkgs/by-name/ha/hatch/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - hatch - 1.16.3-r1: normalized package name match | Alpine Linux edge package indexes: hatch from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Modern, extensible Python project management | https://hatch.pypa.io/latest/ - apk - hatch-pyc - 1.16.3-r1: normalized package name match | Alpine Linux edge package indexes: hatch-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for hatch | https://hatch.pypa.io/latest/ - dnf - hatch - 1.17.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: hatch from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A modern project, package, and virtual env manager | https://github.com/pypa/hatch - MacPorts - hatch: normalized package name match | MacPorts ports tree: python/hatch/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/hatch: normalized package name match | Scoop official bucket manifest trees: bucket/hatch.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - PyPA.Hatch: normalized package name match | Windows Package Manager source index: PyPA.Hatch from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [uv](https://www.automicvault.com/pkg/brew/uv/) - Runtime dependency declared by Homebrew. - [poetry](https://www.automicvault.com/pkg/brew/poetry/) - Shares av.db curated category or tags: cli, developer-tools, packaging, python, virtual-environments. - [abi3audit](https://www.automicvault.com/pkg/brew/abi3audit/) - Shares av.db curated category or tags: cli, developer-tools, packaging, python. - [flit](https://www.automicvault.com/pkg/brew/flit/) - Shares av.db curated category or tags: cli, developer-tools, packaging, python. - [pdm](https://www.automicvault.com/pkg/brew/pdm/) - Shares av.db curated category or tags: cli, developer-tools, packaging, python. - [pipx](https://www.automicvault.com/pkg/brew/pipx/) - Shares av.db curated category or tags: cli, developer-tools, python, virtual-environments. - [rye](https://www.automicvault.com/pkg/brew/rye/) - Shares av.db curated category or tags: cli, developer-tools, project-management, python. - [chardet](https://www.automicvault.com/pkg/brew/chardet/) - Shares av.db curated category or tags: cli, developer-tools, python. - [fades](https://www.automicvault.com/pkg/brew/fades/) - Shares av.db curated category or tags: cli, developer-tools, python. - [pipenv](https://www.automicvault.com/pkg/brew/pipenv/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, developer, developer-tools, environments. ## Combined YAML source View the package source record on GitHub. [combined/hatch.yml](https://github.com/automic-vault/db/blob/main/combined/hatch.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph