Run a command provided by a Python package. Usage: uvx [OPTIONS] [COMMAND] Options: --from Use the given package to provide the command -w, --with Run with the given packages installed --with-editable Run with the given packages installed in editable mode --with-requirements Run with the packages listed in the given files -c, --constraints Constrain versions using the given requirements files [env: `UV_CONSTRAINT`=] -b, --build-constraints Constrain build dependencies using the given requirements files when building source distributions [env: `UV_BUILD_CONSTRAINT`=] --overrides Override versions using the given requirements files [env: `UV_OVERRIDE`=] --isolated Run the tool in an isolated virtual environment, ignoring any already-installed tools [env: UV_ISOLATED=] --env-file Load environment variables from a `.env` file [env: UV_ENV_FILE=] --no-env-file Avoid reading environment variables from a `.env` file [env: UV_NO_ENV_FILE=] --lfs Whether to use Git LFS when adding a dependency from Git --python-platform The platform for which requirements should be installed [possible values: windows, linux, macos, x86_64-pc-windows-msvc, aarch64-pc-windows-msvc, i686-pc-windows-msvc, x86_64-unknown-linux-gnu, aarch64-apple-darwin, x86_64-apple-darwin, aarch64-unknown-linux-gnu, aarch64-unknown-linux-musl, x86_64-unknown-linux-musl, riscv64-unknown-linux, x86_64-manylinux2014, x86_64-manylinux_2_17, x86_64-manylinux_2_28, x86_64-manylinux_2_31, x86_64-manylinux_2_32, x86_64-manylinux_2_33, x86_64-manylinux_2_34, x86_64-manylinux_2_35, x86_64-manylinux_2_36, x86_64-manylinux_2_37, x86_64-manylinux_2_38, x86_64-manylinux_2_39, x86_64-manylinux_2_40, aarch64-manylinux2014, aarch64-manylinux_2_17, aarch64-manylinux_2_28, aarch64-manylinux_2_31, aarch64-manylinux_2_32, aarch64-manylinux_2_33, aarch64-manylinux_2_34, aarch64-manylinux_2_35, aarch64-manylinux_2_36, aarch64-manylinux_2_37, aarch64-manylinux_2_38, aarch64-manylinux_2_39, aarch64-manylinux_2_40, aarch64-linux-android, x86_64-linux-android, wasm32-pyodide2024, wasm32-pyodide2025, arm64-apple-ios, arm64-apple-ios-simulator, x86_64-apple-ios-simulator] --torch-backend The backend to use when fetching packages in the PyTorch ecosystem (e.g., `cpu`, `cu126`, or `auto`) [env: UV_TORCH_BACKEND=] [possible values: auto, cpu, cu132, cu130, cu129, cu128, cu126, cu125, cu124, cu123, cu122, cu121, cu120, cu118, cu117, cu116, cu115, cu114, cu113, cu112, cu111, cu110, cu102, cu101, cu100, cu92, cu91, cu90, cu80, rocm7.2, rocm7.1, rocm7.0, rocm6.4, rocm6.3, rocm6.2.4, rocm6.2, rocm6.1, rocm6.0, rocm5.7, rocm5.6, rocm5.5, rocm5.4.2, rocm5.4, rocm5.3, rocm5.2, rocm5.1.1, rocm4.2, rocm4.1, rocm4.0.1, xpu] -V, --version Display the uvx version Index options: --index The indexes to use when resolving dependencies, in addition to the default index [env: UV_INDEX] --default-index The default package index (by default: ) [env: UV_DEFAULT_INDEX] -i, --index-url (Deprecated: use `--default-index` instead) The URL of the Python package index (by default: ) [env: UV_INDEX_URL] --extra-index-url (Deprecated: use `--index` instead) Extra URLs of package indexes to use, in addition to `--index-url` [env: UV_EXTRA_INDEX_URL] -f, --find-links Locations to search for candidate distributions, in addition to those found in the registry indexes [env: UV_FIND_LINKS] --no-index Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via `--find-links` --index-strategy The strategy to use when resolving against multiple index URLs [env: UV_INDEX_STRATEGY=] [possible values: first-index, unsafe-first-match, unsafe-best-match] --keyring-provider Attempt to use `keyring` for authentication for index URLs [env: UV_KEYRING_PROVIDER=] [possible values: disabled, subprocess] Resolver options: -U, --upgrade Allow package upgrades, ignoring pinned versions in any existing output file. Implies `--refresh` -P, --upgrade-package Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies `--refresh-package` --upgrade-group Allow upgrades for all packages in a dependency group, ignoring pinned versions in any existing output file --resolution The strategy to use when selecting between the different compatible versions for a given package requirement [env: UV_RESOLUTION=] [possible values: highest, lowest, lowest-direct] --prerelease The strategy to use when considering pre-release versions [env: UV_PRERELEASE=] [possible values: disallow, allow, if-necessary, explicit, if-necessary-or-explicit] --prerelease-package The strategy to use when considering pre-release versions for a specific package --fork-strategy The strategy to use when selecting multiple versions of a given package across Python versions and platforms [env: UV_FORK_STRATEGY=] [possible values: fewest, requires-python] --exclude-newer Limit candidate packages to those that were uploaded prior to the given date [env: UV_EXCLUDE_NEWER=] --exclude-newer-package Limit candidate packages for specific packages to those that were uploaded prior to the given date --no-sources Ignore the `tool.uv.sources` table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources [env: UV_NO_SOURCES=] --no-sources-package Don't use sources from the `tool.uv.sources` table for the specified packages [env: `UV_NO_SOURCES_PACKAGE`=] Installer options: --reinstall Reinstall all packages, regardless of whether they're already installed. Implies `--refresh` --reinstall-package Reinstall a specific package, regardless of whether it's already installed. Implies `--refresh-package` --link-mode The method to use when installing packages from the global cache [env: UV_LINK_MODE=] [possible values: clone, copy, hardlink, symlink] --compile-bytecode Compile Python files to bytecode after installation [env: UV_COMPILE_BYTECODE=] Build options: -C, --config-setting Settings to pass to the PEP 517 build backend, specified as `KEY=VALUE` pairs --config-settings-package Settings to pass to the PEP 517 build backend for a specific package, specified as `PACKAGE:KEY=VALUE` pairs --no-build-isolation Disable isolation when building source distributions [env: UV_NO_BUILD_ISOLATION=] --no-build-isolation-package Disable isolation when building source distributions for a specific package --no-build Don't build source distributions [env: UV_NO_BUILD=] --no-build-package Don't build source distributions for a specific package [env: `UV_NO_BUILD_PACKAGE`=] --no-binary Don't install pre-built wheels [env: UV_NO_BINARY=] --no-binary-package Don't install pre-built wheels for a specific package [env: `UV_NO_BINARY_PACKAGE`=] --require-build-hashes Require hashes for all build dependencies --no-require-build-hashes Do not require hashes for every build dependency Cache options: -n, --no-cache Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operation [env: UV_NO_CACHE=] --cache-dir Path to the cache directory [env: UV_CACHE_DIR=] --refresh Refresh all cached data --refresh-package Refresh cached data for a specific package Python options: -p, --python The Python interpreter to use to build the run environment. [env: UV_PYTHON=] --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=] --no-python-downloads Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"] Global options: -q, --quiet... Use quiet output -v, --verbose... Use verbose output --color Control the use of color in output [possible values: auto, always, never] --system-certs Whether to load TLS certificates from the platform's native certificate store [env: UV_SYSTEM_CERTS=] --offline Disable network access [env: UV_OFFLINE=] --allow-insecure-host Allow insecure connections to a host [env: UV_INSECURE_HOST=] --no-progress Hide all progress outputs [env: UV_NO_PROGRESS=] --directory Change to the given directory prior to running the command [env: UV_WORKING_DIR=] --project Discover a project in the given directory [env: UV_PROJECT=] --config-file The path to a `uv.toml` file to use for configuration [env: UV_CONFIG_FILE=] --no-config Avoid discovering configuration files (`pyproject.toml`, `uv.toml`) [env: UV_NO_CONFIG=] -h, --help Display the concise help for this command Use `uv help tool run` for more details.