UV(1)

📦 version 0.11.20, in ubuntu stonking

💖 UV(1) — the user commands one 💖

okay so bestie, welcome to section 1 of the manual (the User Commands one, iykyk) and this is literally all about uv. buckle up. 🎀

✨ NAME ✨

uv — an extremely fast Python package installer and resolver. like, it's serving speed. 🔥

🦋 SYNOPSIS 🦋

uv [OPTIONS] <COMMAND>

💅 DESCRIPTION 💅

An extremely fast Python package manager. that's the whole vibe. she does everything and she does it fast. periodt. 👑

🌸 Commands: 🌸

these are the main character subcommands, pick your fighter:

  • auth — deal with authentication. 🔐
  • run — run a command or a script.
  • init — make a brand new project.
  • add — add dependencies to the project.
  • remove — take dependencies back out of 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 into an alternate format.
  • tree — show the project's dependency tree. 🌳
  • format — format the Python code in the project.
  • check — run checks on the project.
  • audit — audit the project's dependencies.
  • tool — run and install commands that Python packages provide.
  • python — manage Python versions and installations.
  • pip — manage Python packages through 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 itself.
  • help — display documentation for a command. (yes she documents herself, icon behaviour.)

🍓 Cache options: 🍓

  • -n, --no-cache — don't read from the cache and don't write to it either; instead she uses a temporary directory just for the duration of the operation. [env: UV_NO_CACHE=]
  • --cache-dir <CACHE_DIR> — the path to the cache directory. [env: UV_CACHE_DIR=]

🧚 Python options: 🧚

  • --managed-python — require that you use uv-managed Python versions. [env: UV_MANAGED_PYTHON=]
  • --no-managed-python — turn off the use of uv-managed Python versions. [env: UV_NO_MANAGED_PYTHON=]
  • --no-python-downloads — turn off 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 whether colour gets used 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 every progress output. [env: UV_NO_PROGRESS=]
  • --directory <DIRECTORY> — change into the given directory before running the command. [env: UV_WORKING_DIR=]
  • --project <PROJECT> — discover a project inside 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 — don't discover 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.
✨ and if you want more details? use uv help. she'll tell you everything, no gatekeeping. 🫶

okay that's the whole page, bestie, you ate that. 💖 this was uv version 0.11.20+ds, from August 2026 — see you in the next one, slay! 🌈👑✨

📦 where this page comes from