tldr/pages/common/uv-run.md

uv run

Run a command or script in the project environment. More information: https://docs.astral.sh/uv/reference/cli/#uv-run.

• Run a Python script:

uv run {{path/to/script.py}}

• Run a Python module:

uv run {{[-m|--module]}} {{module_name}}

• Run a command with additional packages installed temporarily:

uv run {{[-w|--with]}} {{package}} {{command}}

• Run a script with packages from a requirements file:

uv run --with-requirements {{path/to/requirements.txt}} {{path/to/script.py}}

• Run in an isolated environment (no project dependencies):

uv run --isolated {{path/to/script.py}}

• Run without syncing the environment first:

uv run --no-sync {{command}}