Hatch
hatch.pypa.io
- Free plan
- Windows
- macOS
- Linux
What Hatch is
Hatch is a free, MIT-licensed Python project manager for creating projects and managing development environments on Linux, macOS, and Windows. It can generate projects from templates or initialize existing ones, including migrating setuptools configuration from setup.py. Environment management supports custom scripts and UV, with manual Python installations or automatic installation within environments. Hatch supports reproducible builds, test execution, and static analysis backed by Ruff. It can publish packages to PyPI and other package indices; lockfile support, dependency groups, and private registry support are also listed capabilities. The pluggy-based extension system supports project tasks such as environments, builders, and publishers. Visual Studio Code can discover Hatch environments through the vscode-python extension, and the installation guide documents an official GitHub Actions install action. Installation choices include standalone installers or binaries as well as pip, pipx, Homebrew, and Conda. The documentation provides a self-report command that prepares a GitHub issue for unexpected behavior.
Who it suits
Hatch suits Python developers who want project setup, environment management, testing, and package publishing in one project manager. It is available across Linux, macOS, and Windows and can be extended through plugins.
Good to know, and what to watch
- Creates projects from templates and initializes existing projects.
- Supports custom environment scripts and UV.
- Runs tests and static analysis backed by Ruff.
- Publishes packages to PyPI or other package indices.
- Free and distributed under the MIT license.
- Python-focused rather than a general project manager.
- Unexpected behavior reporting uses a command that prepares a GitHub issue.
Plans
Every plan and priceHatch
Open source
Getting started
- Open the Hatch website and choose an installation method
- Install Hatch with a standalone installer, binary, pip, pipx, Homebrew, Conda or another documented route
- Create a project from a template or initialize an existing project
- Configure environments, custom scripts and Python installation behavior
- Run tests and static analysis, then publish packages to PyPI or another index
Limits to check
Hatch is centered on Python projects and its listed plan is free at no cost. No free-trial period applies to the free, MIT-licensed project manager.
The Club's review
Hatch is a command-line tool for managing the working life of Python projects. It suits individual developers and teams that want one configurable workflow for environments, checks, builds, and releases. Its strongest case is a reproducible, extensible Python process; it is a poor fit if you need a hosted development workspace or a graphical project hub.
Overview
Hatch can generate a new project from a template, initialize an existing codebase, and move setuptools configuration out of setup.py. That makes it useful both at project start and during a packaging-workflow migration. Lockfiles, dependency groups, and private-registry support add controls that basic installation commands do not provide.
The project is free and open source under the MIT license. It is a local project manager rather than a hosted service, so teams retain responsibility for their environments, credentials, and release process. Documentation points users to hatch self report for collecting information when reporting unexpected behavior through GitHub.
Key features
Environments and Python versions
Hatch creates and manages environments, supports custom scripts, and can use UV. Python may come from a manual installation or be installed automatically as part of an environment. This gives teams control over how interpreters are provisioned, while also requiring them to settle on a convention that everyone follows.
Builds and extensions
Reproducible-build support is valuable when the same source must produce dependable artifacts on different machines. Hatch uses pluggy and documents extension points for environments, builders, publishers, and other tasks. That architecture can accommodate specialized workflows, although every added plugin becomes another component to select, configure, and maintain.
Testing, analysis, and publishing
The test command uses pytest with selected plugins and coverage.py by default, giving a project a ready-made testing path rather than just an environment shell. Static analysis is provided through Ruff, with defaults the project presents as current and sensible. Hatch can upload packages to PyPI or other package indices, so the same tool can carry a project from checks to distribution.
Editor and automation integration
The vscode-python extension can discover Hatch environments, which reduces friction for Visual Studio Code users. An official GitHub Actions install action also helps place Hatch in CI workflows. These integrations matter most to teams standardizing local and automated execution around the same project configuration.
Pricing
| Plan | Price | What it includes |
|---|---|---|
| Hatch | Free | MIT-licensed Python project manager with lockfile support, environment management, package publishing, private-registry support, and dependency groups |
There is no paid tier, trial period, seat charge, quota, or renewal term stated for this plan. It is therefore a straightforward choice for open-source projects, freelancers, and organizations comfortable operating their own Python tooling. The trade-off is that the price covers software, not a hosted workspace or managed support service.
Platforms
Hatch supports Linux, macOS, and Windows. Installation options include platform installers or standalone binaries, as well as pip, pipx, Homebrew, Conda, and other methods. That breadth lets teams use a preferred distribution route while keeping the project tool cross-platform.
Who it's for
Choose Hatch when a Python team needs environment management, repeatable builds, testing, analysis, and package publication in one extensible workflow. It is especially suitable for maintainers modernizing setuptools projects or organizations that need private registries and dependency groups. It is not aimed at users who want a browser-based notebook, hosted collaboration space, or a package installer without broader project-management responsibilities.
Pros and cons
- Pros: One workflow covers project creation, environments, tests, analysis, builds, and publishing.
- Pros: Reproducible builds, lockfiles, and dependency groups support more controlled team processes.
- Pros: Pluggy-based extensions can adapt environments, builders, and publishers to unusual requirements.
- Pros: Cross-platform installers and package-manager options simplify adoption across mixed operating systems.
- Cons: Its command-line, project-centered design does not provide a hosted workspace.
- Cons: Plugin flexibility introduces configuration and maintenance decisions that smaller projects may not need.
Alternatives
Python Package Managers is a useful category overview when you want to compare the wider field before choosing a workflow.
- ActiveState Platform is the better choice for a hosted, freemium service with web and API access; its free organization plan is limited to public projects.
- pip-tools suits users who want focused command-line dependency tools installed per virtual environment rather than an all-in-one project manager.
- Pixi is worth considering for cross-platform package environments and optional prefix.dev hosting plans.
- Anaconda Notebooks fits browser-based notebook work with cloud storage and paid storage tiers.
- Mamba is a free BSD-3-Clause-licensed option for environment and package management.
- Nox is a free, open-source alternative for automating sessions across Linux, macOS, and Windows.
- pip is the simpler free installer when you do not need Hatch's project lifecycle features.
- Twine is a focused free package-upload tool rather than a complete project manager.
Verdict
Hatch is a strong default for Python teams that want one MIT-licensed tool to create projects, control environments, run quality checks, build reproducibly, and publish packages. Choose it for breadth and extensibility; look elsewhere when your priority is a hosted workspace or a narrowly focused installer, environment tool, or upload utility.
The verdict
Hatch brings Python project setup, environment management, testing, and publishing together, with plugin extensions and multiple installation methods. Its capabilities are centered on Python development, so it is most relevant to teams working in that ecosystem.
Questions people ask
How much does Hatch cost?
The listed Hatch plan costs nothing and is free. Hatch is distributed under the MIT license.
Which operating systems does Hatch support?
Hatch supports Linux, macOS and Windows.
Can Hatch manage Python environments?
Yes. It supports custom scripts, UV, manual Python installations and automatic installation as part of environments.
Can Hatch publish packages?
Yes. Hatch can upload packages to PyPI and other package indices, with private registry support listed.
Does Hatch support plugins?
Yes. Hatch uses pluggy and documents plugin types for builders, environments, publishers and other project tasks.
Does Hatch work with Visual Studio Code?
The vscode-python extension supports Hatch environment discovery in Visual Studio Code.
What the maker publishes
- Builds
- Hatch supports reproducible builds and a rich ecosystem of plugins. source
- Builds
- Hatch supports reproducible builds and a plugin ecosystem. source
- Environments
- Hatch provides environment management with custom scripts and UV support. source
- Environments
- Hatch provides environment management with custom scripts and support for uv. source
- Extensibility
- Hatch uses pluggy for plugin functionality and documents plugin types for environments, builders, publishers, and other project tasks. source
- Installation
- The installation documentation provides installers or standalone binaries for Windows, macOS, and Linux, as well as pip, pipx, Homebrew, Conda, and other installation methods. source
- Integration
- Visual Studio Code supports Hatch environment discovery through the vscode-python extension. source
- Integrations
- The installation guide documents an official GitHub Actions install action. source
- License
- Hatch is distributed under the MIT license. source
- License
- Hatch is distributed under the MIT license. source
- Maintainer
- The documentation footer credits Ofek Lev. source
- Maintainer
- The documentation copyright identifies Ofek Lev as the copyright holder from 2017 to present. source
- Platforms
- The installation guide provides installers or standalone binaries for macOS, Windows, and Linux. source
- Plugins
- Hatch uses pluggy for plugin functionality, and its documentation describes plugin types for builders, environments, publishers, and other extensions. source
- Product
- Hatch describes itself as a modern, extensible Python project manager. source
- Product
- Hatch describes itself as a modern, extensible Python project manager. source
- Project creation
- Hatch can create new projects from templates. source
- Project setup
- Hatch can create projects from templates and initialize existing projects, including migrating setuptools configuration from setup.py. source
- Publishing
- Hatch can upload packages to PyPI or other package indices. source
- Publishing
- Hatch can publish built projects to PyPI or other package indexes. source
- Python management
- Hatch supports manual Python installations and automatic installation as part of environments. source
- Python management
- Hatch supports manual Python installation or automatic installation as part of environments. source
- Static analysis
- Hatch’s static analysis feature is backed by Ruff and uses defaults the project describes as up to date and sensible. source
- Support
- The documentation directs users to report unexpected behavior using the hatch self report command, which prepares an issue on GitHub. source
Checked against the maker's pages on 4 Oct 2026.