Files
uv/docs/first-steps.md
Zanie Blue 37a60a57e8 Prompt an early jump to the feature overview during first steps (#5655)
Addressing some feedback about the first-steps covering the help and
version commands.

I'm not sure what else to do here since the first steps with uv are very
dependent on the features you need.
2024-07-31 10:13:04 -05:00

1.5 KiB

First steps with uv

uv only provides a command-line interface and must be used from a terminal.

After installing uv, you can check that uv is installed by running the uv command:

$ uv

You should see a help menu listing the available commands.

Read on for a brief overview of the help menu and version command, or jump to an overview of features to start using uv.

Help menus

The --help flag can be used to view the help menu for a command, e.g., for uv:

$ uv --help

To view the help menu for a specific command, e.g., for uv init:

$ uv init --help

When using the --help flag, uv displays a condensed help menu. To view a longer help menu for a command, use uv help:

$ uv help

To view the long help menu for a specific command, e.g., for uv init:

$ uv help init

When using the long help menu, uv will attempt to use less or more to "page" the output so it is not all displayed at once. To exit the pager, press q.

Viewing the version

To check the installed version:

$ uv version

The following are also valid:

$ uv --version      # Same output as `uv version`
$ uv -V             # Will not include the build commit and date
$ uv pip --version  # Can be used with a subcommand

Next steps

Now that you've confirmed uv is installed and know how to get help, check out an overview of features or jump straight into the guides to start using uv.