All apps/uv

uv

uv

An extremely fast Python package and project manager, written in Rust.

Runs as uv, uvx|macOS, Linux, Windows|docs.astral.sh

Command form

ai-draft · 8 tasks · 45 fields

Python project and package manager. Forms cover add, run, sync and venv; global flags and index/resolution tuning are left out.

Opens the form; the finished command lands at your prompt, unrun
otty gui uv

uv add

Add dependencies

Add packages to the project in the current directory. Index, resolution and build options are left out.

Add dependenciesExample values, fixed in this page — nothing here reaches a terminal
Basic
Packages*
string
TasksEach one presets the form for one job
Add packages
packages
Add dev dependency
packagesdev
ParametersOnly these flags are editable in the form
Packages
Package specifiers, e.g. requests or "flask>=3".
string · positional 0 · repeatable
Development dependency
boolean
--dev
Dependency group
string
--group
Optional extra
Add to the named optional-dependencies extra.
string
--optional
Editable
boolean
--editable
Enable extra
string
--extra
Git revision
string
--rev
Git tag
string
--tag
Git branch
string
--branch
Workspace package
string
--package
Allow upgrades
boolean
-U

uv run

Run a command

Run a command or script in the project environment. Arguments for the command itself are typed after it.

Run a commandExample values, fixed in this page — nothing here reaches a terminal
Basic
Command*
string
TasksEach one presets the form for one job
Run command
command
Run with extra package
commandwith
ParametersOnly these flags are editable in the form
Command
Command or script to run.
string · positional 0
Extra package
Run with this package installed.
string
--with
Run as module
boolean
-m--module
Treat as script
boolean
-s--script
Isolated environment
boolean
--isolated
Skip sync
boolean
--no-sync
Assert lockfile unchanged
boolean
--locked
Do not update lockfile
boolean
--frozen
Omit dev group
boolean
--no-dev
All extras
boolean
--all-extras
Extra
string
--extra
Group
string
--group
Env file
path
--env-file
Workspace package
string
--package
No project
boolean
--no-project

uv sync

Sync environment

Update the project's environment from the lockfile.

Sync environmentExample values, fixed in this page — nothing here reaches a terminal
Basic
All extras
--all-extras
Omit dev group
--no-dev
TasksEach one presets the form for one job
Sync
no_devall_extras
Sync and upgrade
upgrade
ParametersOnly these flags are editable in the form
All extras
boolean
--all-extras
Extra
string
--extra
Omit dev group
boolean
--no-dev
Only dev group
boolean
--only-dev
Group
string
--group
All groups
boolean
--all-groups
Keep extraneous packages
boolean
--inexact
Skip current project
boolean
--no-install-project
All workspace packages
boolean
--all-packages
Workspace package
string
--package
Allow upgrades
boolean
-U

uv venv

Create virtual environment

Create a virtual environment; the target path is the last argument.

Create virtual environmentExample values, fixed in this page — nothing here reaches a terminal
Basic
Path
directory
Python
string
TasksEach one presets the form for one job
Create .venv
venv_pathpython
Create with pip
venv_pathpythonseed
ParametersOnly these flags are editable in the form
Path
path · positional 0
Python
Interpreter or version, e.g. 3.12.
string
-p--python3.133.123.11
Seed pip
boolean
--seed
System site packages
boolean
--system-site-packages
Allow existing
boolean
--allow-existing
Prompt
string
--prompt
Relocatable
boolean
--relocatable
No project
boolean
--no-project
SourcesEvery flag above is checked against these
fig
completion

github.com

fig
completion

github.com

fig
completion

github.com

fig
completion

github.com

fig
completion

github.com

Before it fills your prompt, Otty checks the installed uv against its version. A form that does not match your version is not offered.