How do I make Hatch use uv as its installer?

Add `installer = "uv"` to the environment configuration in `pyproject.toml`, under `[tool.hatch.envs.default]` for the default environment or `[tool.hatch.envs.test]` for a named environment. Hatch then calls uv instead of pip and virtualenv when it creates the environment and installs dependencies. The rest of the Hatch workflow stays the same.

Can I enable uv across all Hatch projects without editing every pyproject.toml?

Yes. Set `HATCH_ENV_TYPE_VIRTUAL_UV_PATH` to the absolute path of your uv binary, for example `export HATCH_ENV_TYPE_VIRTUAL_UV_PATH="$(which uv)"` on macOS or Linux, or `$env:HATCH_ENV_TYPE_VIRTUAL_UV_PATH = (Get-Command uv).Source` on Windows. Add it to your shell profile to keep it permanent. Hatch then uses uv for every project it manages.

How do I verify Hatch is using uv?

Recreate your environment with `hatch env prune` followed by `hatch env create`. The install step should be noticeably faster than with pip. To force a clean test, run Hatch from a project where `installer = "uv"` is set, then watch the output for uv-style messages instead of pip's. A measurable drop in environment-creation time confirms the switch.

How to use uv to speed up Hatch

by Tim Hopper · Markdown

uv Packaging verified with uv 0.12 verified with hatch 1.18

Hatch can use uv as its installer backend instead of pip and virtualenv. This makes environment creation and dependency installation 10-100x faster without changing the rest of your Hatch workflow.

Note

This guide assumes you already have a Hatch project and uv installed.

Enable uv in your project

Add installer = "uv" to your default environment configuration in pyproject.toml:

[tool.hatch.envs.default]
installer = "uv"

This applies to the default environment. To enable uv for a specific environment like test:

[tool.hatch.envs.test]
installer = "uv"

Enable uv globally with an environment variable

To use uv across all Hatch projects without editing each pyproject.toml, set the HATCH_ENV_TYPE_VIRTUAL_UV_PATH environment variable to the absolute path of your uv binary:

export HATCH_ENV_TYPE_VIRTUAL_UV_PATH="$(which uv)"

Add this to your shell profile to make it permanent.

Verify it’s working

Recreate your environment to confirm uv is active:

hatch env prune
hatch env create

Dependency installation should complete noticeably faster than before.

Learn more

uv: A Complete Guide covers what uv does, how fast it is, the core workflows, and recent releases.
Hatch reference page
uv reference page
Hatch installer documentation

Last updated on August 11, 2026

How to Use uv on Windows ARM64 How to use uv to speed up PDM

Please submit corrections and feedback...