CLI Reference

uv

An extremely fast Python package manager.

Usage

uv [OPTIONS] <COMMAND>

Commands

uv auth: Manage authentication
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 version: Read or update the project's version
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 format: Format Python code in the project
uv tool: Run and install commands provided by Python packages
uv python: Manage Python versions and installations
uv pip: Manage Python packages with a pip-compatible interface
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 self: Manage the uv executable
uv help: Display documentation for a command

uv auth

Manage authentication

Usage

uv auth [OPTIONS] <COMMAND>

Commands

uv auth login: Login to a service
uv auth logout: Logout of a service
uv auth token: Show the authentication token for a service
uv auth dir: Show the path to the uv credentials directory

Login to a service

Usage

uv auth login [OPTIONS] <SERVICE>

Arguments

SERVICE: The domain or URL of the service to log into

Options

--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.

Can be provided multiple times.

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.

May also be set with the UV_INSECURE_HOST environment variable.

--cache-dir cache-dir

Path to the cache directory.

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.

To view the location of the cache directory, run uv cache dir.

May also be set with the UV_CACHE_DIR environment variable.

--color color-choice

Control the use of color in output.

By default, uv will automatically detect support for colors when writing to a terminal.

Possible values:

auto: Enables colored output only when the output is going to a terminal or TTY with support
always: Enables colored output regardless of the detected environment
never: Disables colored output

--config-file config-file