Subcommands44 subcommands
uv run
Run a command or script
uv init
Create a new project
uv add
Add dependencies to the project
uv remove
Remove dependencies from the project
uv sync
Update the project's environment
uv lock
Update the project's lockfile
uv export
Export the project's lockfile to an alternate format
uv tree
Display the project's dependency tree
uv tool
Run and install commands provided by Python packages
uv tool run
Run a command provided by a Python package
uv tool install
Install commands provided by a Python package
uv tool upgrade
Upgrade installed tools
uv tool list
List installed tools
uv tool uninstall
Uninstall a tool
uv tool update-shell
Ensure that the tool executable directory is on the `PATH`
uv tool dir
Show the path to the uv tools directory
uv python
Manage Python versions and installations
uv python list
List the available Python installations
uv python install
Download and install Python versions
uv python find
Search for a Python installation
uv python pin
Pin to a specific Python version
uv python dir
Show the uv Python installation directory
uv python uninstall
Uninstall Python versions
uv pip
Manage Python packages with a pip-compatible interface
uv pip compile
Compile a `requirements.in` file to a `requirements.txt` file
uv pip sync
Sync an environment with a `requirements.txt` file
uv pip install
Install packages into an environment
uv pip uninstall
Uninstall packages from an environment
uv pip freeze
List, in requirements format, packages installed in an environment
uv pip list
List, in tabular format, packages installed in an environment
uv pip show
Show information about one or more installed packages
uv pip tree
Display the dependency tree for an environment
uv pip check
Verify installed packages have compatible dependencies
uv venv
Create a virtual environment
uv build
Build Python packages into source distributions and wheels
uv publish
Upload distributions to an index
uv cache
Manage uv's cache
uv cache clean
Clear the cache
uv cache prune
Prune all unreachable objects from the cache
uv cache dir
Show the cache directory
uv self
Manage the uv executable
uv version
Display uv's version
uv help
Display documentation for a command
OptionsOn uv itself
-q--quiet
Do not print any output
-v--verbose
Use verbose output
--color
Control colors in output <COLOR_CHOICE>
--native-tls
Whether to load TLS certificates from the platform's native certificate store <BOOL>
--offline
Disable network access
--allow-insecure-host
Allow insecure connections to a host <ALLOW_INSECURE_HOST>
--no-progress
Hide all progress outputs
--directory
Change to the given directory prior to running the command <DIRECTORY>
--project
Run the command within the given project directory <PROJECT>
--config-file
The path to a `uv.toml` file to use for configuration <CONFIG_FILE>
--no-config
Avoid discovering configuration files (`pyproject.toml`, `uv.toml`)
-h--help
Display the concise help for this command
-V--version
Display the uv version
