Skip to content

Installation

This page is the primary entrypoint for installing LAV2.

Requirements

  • uv as the recommended environment and dependency manager
  • Optional simulator backend prerequisites and GPU support depending on the workflow you plan to use

For the default workflow, use uv to manage the Python environment and install the project dependencies (and common extras):

uv sync

# with common extras
uv sync --all-extras

For an editable install:

uv pip install -e .

# with development tooling and common extras
uv pip install -e . --group dev --all-extras

Fallback Setup

If you are not using uv, install with pip:

pip install -e .

# with common extras
pip install -e .[gamepad,onnx]

# with the dev dependency group (requires pip 25.1+)
pip install --group dev -e .[gamepad,onnx]

The --group option is supported by modern pip, but it was added in pip 25.1. If your local pip is older, prefer the uv workflow above.

Next Steps