OS Manuals

/usr/bin/uv

An extremely fast Python package installer and resolver, written in Rust.

From uv 0.13.7-r0 (os), captured 2026-11-05 by running uv --help (exit 0). permalink

An extremely fast Python package manager.

Usage: uv [OPTIONS] <COMMAND>

Commands:
  auth       Manage authentication
  run        Run a command or script
  init       Create a new project
  add        Add dependencies to the project
  remove     Remove dependencies from the project
  version    Read or update the project's version
  sync       Update the project's environment
  lock       Update the project's lockfile
  export     Export the project's lockfile to an alternate format
  tree       Display the project's dependency tree
  format     Format Python code in the project
  check      Run checks on the project
  audit      Audit the project's dependencies
  tool       Run and install commands provided by Python packages
  python     Manage Python versions and installations
  pip        Manage Python packages with a pip-compatible interface
  venv       Create a virtual environment
  build      Build Python packages into source distributions and wheels
  publish    Upload distributions to an index
  workspace  Inspect uv workspaces
  cache      Manage uv's cache
  self       Manage the uv executable
  help       Display documentation for a command

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 <CACHE_DIR>  Path to the cache directory [env: UV_CACHE_DIR=]

Python options:
      --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 <COLOR_CHOICE>
          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_HOST>
          Allow insecure connections to a host [env: UV_INSECURE_HOST=]
      --no-progress
          Hide all progress outputs [env: UV_NO_PROGRESS=]
      --directory <DIRECTORY>
          Change to the given directory prior to running the command [env: UV_WORKING_DIR=]
      --project <PROJECT>
          Discover a project in the given directory [env: UV_PROJECT=]
      --config-file <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
  -V, --version
          Display the uv version

Use `uv help` for more details.
Options (18)
OptionDescriptionSource
-n, --no-cacheAvoid reading from or writing to the cache, instead using a temporary directory for the duration of the operation [env: UV_NO_CACHE=]help
--cache-dir CACHE_DIRPath to the cache directory [env: UV_CACHE_DIR=]help
--managed-pythonRequire use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]help
--no-managed-pythonDisable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]help
--no-python-downloadsDisable automatic downloads of Python.help
-q, --quietUse quiet outputhelp
-v, --verboseUse verbose outputhelp
--color COLOR_CHOICEControl the use of color in output [possible values: auto, always, never]help
--system-certsWhether to load TLS certificates from the platform's native certificate store [env: UV_SYSTEM_CERTS=]help
--offlineDisable network access [env: UV_OFFLINE=]help
--allow-insecure-host ALLOW_INSECURE_HOSTAllow insecure connections to a host [env: UV_INSECURE_HOST=]help
--no-progressHide all progress outputs [env: UV_NO_PROGRESS=]help
--directory DIRECTORYChange to the given directory prior to running the command [env: UV_WORKING_DIR=]help
--project PROJECTDiscover a project in the given directory [env: UV_PROJECT=]help
--config-file CONFIG_FILEThe path to a `uv.toml` file to use for configuration [env: UV_CONFIG_FILE=]help
--no-configAvoid discovering configuration files (`pyproject.toml`, `uv.toml`) [env: UV_NO_CONFIG=]help
-h, --helpDisplay the concise help for this commandhelp
-V, --versionDisplay the uv versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.