Skip to content

Add hatch installation option with uvx #2009

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

eugengi
Copy link

@eugengi eugengi commented Jun 23, 2025

Description

uv has grown to have a large community and rapid adoption. This PR introduces a minor patch to the install docs to inform users of an optional Hatch installation with uv. Users, or anyone managing isolated tools with uv, can now install Hatch in a persistent, isolated, globally available environment.

Decisions

This section outlines notable considerations for developers/maintainers.

  • uvx (an alias for uv tool run <tool>) executes tools in a temporary, cached virtual environment.
  • uv tool run <tool> installs tools in a persistent, isolated, global environment, similar to pipx.

Similar Workflow

Action pipx Command uv Equivalent
Install globally pipx install black uv tool install black
Run once (ephemeral) pipx run ruff uvx ruff
Run a specific version pipx run ruff==0.4.0 uvx [email protected]
List installed tools pipx list uv tool list
Upgrade a specific tool pipx upgrade black uv tool upgrade black
Upgrade all tools pipx upgrade --all uv tool upgrade --all
Uninstall a tool pipx uninstall black uv tool uninstall black

References

Include an option to install Hatch with uv's tool interface for the uv community and ecosystem.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant