Package hatch

A modern project, package, and virtual env manager

Hatch is a modern, extensible Python project manager.

Features:

  • Standardized build system with reproducible builds by default
  • Robust environment management with support for custom scripts and UV
  • Test execution with known best practices
  • Static analysis with sane defaults
  • Built-in Python script runner
  • Easy publishing to PyPI or other indices
  • Version management
  • Best practice project generation
  • Responsive CLI, ~2-3x faster than equivalent tools

Version: 1.17.0

General Commands
hatch	hatch – Modern, extensible Python project management
hatch-build	hatch build – Build a project
hatch-check	hatch check – Check source code for issues (linting, formatting, type checking)
hatch-check-code	hatch check code – Perform static analysis, using Ruff by default
hatch-check-fmt	hatch check fmt – Verify formatting, using Ruff by default
hatch-check-types	hatch check types – Type check source code, using Pyrefly by default
hatch-clean	hatch clean – Remove build artifacts
hatch-config	hatch config – Manage the config file
hatch-config-explore	hatch config explore – Open the config location in your file manager
hatch-config-find	hatch config find – Show the location of the config file
hatch-config-restore	hatch config restore – Restore the config file to default settings
hatch-config-set	hatch config set – Assign values to config file entries
hatch-config-show	hatch config show – Show the contents of the config file
hatch-config-update	hatch config update – Update the config file with any new fields
hatch-dep	hatch dep – Manage environment dependencies
hatch-dep-hash	hatch dep hash – Output a hash of the currently defined dependencies
hatch-dep-lock	hatch dep lock – Resolve dependencies and write a PEP 751 pylock.toml for the selected environment
hatch-dep-show	hatch dep show – Display dependencies in various formats
hatch-dep-show-requirements	hatch dep show requirements – Enumerate dependencies as a list of requirements
hatch-dep-show-table	hatch dep show table – Enumerate dependencies in a tabular format
hatch-dep-sync	hatch dep sync – Sync the active environment to its lockfile (locked environments only)
hatch-env	hatch env – Manage project environments
hatch-env-create	hatch env create – Create environments
hatch-env-find	hatch env find – Locate environments
hatch-env-lock	hatch env lock – Generate lockfiles for environments
hatch-env-prune	hatch env prune – Remove all environments
hatch-env-remove	hatch env remove – Remove environments
hatch-env-run	hatch env run – Run commands within project environments
hatch-env-show	hatch env show – Show the available environments
hatch-fmt	hatch fmt – Format and lint source code
hatch-lock	hatch lock – Same as hatch-dep-lock(1) for the environment selected with -e / HATCH_ENV
hatch-new	hatch new – Create or initialize a project
hatch-project	hatch project – View project information
hatch-project-metadata	hatch project metadata – Display project metadata
hatch-publish	hatch publish – Publish build artifacts
hatch-python	hatch python – Manage Python installations
hatch-python-find	hatch python find – Locate Python binaries
hatch-python-install	hatch python install – Install Python distributions
hatch-python-remove	hatch python remove – Remove Python distributions
hatch-python-show	hatch python show – Show the available Python distributions
hatch-python-update	hatch python update – Update Python distributions
hatch-run	hatch run – Run commands within project environments
hatch-self	hatch self – Manage Hatch
hatch-self-report	hatch self report – Generate a pre-populated GitHub issue
hatch-self-restore	hatch self restore – Restore the installation
hatch-self-update	hatch self update – Install the latest version
hatch-shell	hatch shell – Enter a shell within a project’s environment
hatch-status	hatch status – Show information about the current environment
hatch-test	hatch test – Run tests using the hatch-test environment matrix
hatch-version	hatch version – View or set a project’s version

General Commands