mirror of
https://github.com/astral-sh/uv.git
synced 2025-11-01 04:17:37 +00:00
69 lines
1.5 KiB
Markdown
69 lines
1.5 KiB
Markdown
# First steps with uv
|
|
|
|
After [installing uv](./installation.md), you can check that uv is available by running the `uv`
|
|
command:
|
|
|
|
```console
|
|
$ uv
|
|
An extremely fast Python package manager.
|
|
|
|
Usage: uv [OPTIONS] <COMMAND>
|
|
|
|
...
|
|
```
|
|
|
|
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](./features.md) to start using uv.
|
|
|
|
## Help menus
|
|
|
|
The `--help` flag can be used to view the help menu for a command, e.g., for `uv`:
|
|
|
|
```console
|
|
$ uv --help
|
|
```
|
|
|
|
To view the help menu for a specific command, e.g., for `uv init`:
|
|
|
|
```console
|
|
$ 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`:
|
|
|
|
```console
|
|
$ uv help
|
|
```
|
|
|
|
To view the long help menu for a specific command, e.g., for `uv init`:
|
|
|
|
```console
|
|
$ 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:
|
|
|
|
```console
|
|
$ uv version
|
|
```
|
|
|
|
The following are also valid:
|
|
|
|
```console
|
|
$ 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](./features.md) or jump to the [guides](../guides/index.md) to start using uv.
|