LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

uv-tool

Install and run Python CLI tools

TLDR

Run a tool without installing
$ uv tool run [tool]
copy
Run a tool from a specific package
$ uv tool run --from [package] [command]
copy
Install a tool globally
$ uv tool install [tool]
copy
Install a tool with extra dependencies
$ uv tool install [tool] --with [extra_package]
copy
List installed tools
$ uv tool list
copy
Upgrade a specific tool
$ uv tool upgrade [tool]
copy
Upgrade all installed tools
$ uv tool upgrade --all
copy
Uninstall a tool
$ uv tool uninstall [tool]
copy

SYNOPSIS

uv tool command [options]

DESCRIPTION

uv tool manages Python CLI tools in isolated virtual environments. Each tool gets its own environment with dependencies, keeping the system clean. Similar to pipx but significantly faster due to uv's Rust-based resolver and installer.Tools can be run temporarily with uv tool run (aliased as uvx), which creates a disposable environment, or installed persistently with uv tool install for permanent PATH availability. The --from option allows running a specific command from a named package, and --with adds extra dependencies to the tool environment. Tool upgrades respect version constraints set during installation.

PARAMETERS

run tool

Run a tool in a temporary isolated environment. Alias: uvx.
install tool
Install a tool globally in an isolated virtual environment.
uninstall tool
Remove an installed tool and its environment.
list
List installed tools and their executables.
upgrade tool
Upgrade an installed tool.
upgrade --all
Upgrade all installed tools.
dir
Show the tools installation directory.
update-shell
Add the tool executable directory to the PATH in shell configuration files.
--from package
Specify the package to install or run the command from.
--with package
Include additional packages in the tool environment.
--python version
Specify the Python interpreter or version to use.

SEE ALSO

uv(1), uv-run(1), uv-pip(1), uvx(1), pipx(1)

Copied to clipboard
Kai