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 planned for use
Recommended Setup
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
uv pip install -e .
# with development tooling and common extras
uv pip install -e . --group dev --all-extras
Fallback Setup
If uv is not being used, 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 the local pip version is older, prefer the uv workflow above.
Choosing Between uv sync and uv pip install -e .
Use uv sync for the repository-managed environment defined by the lockfile. Use uv pip install -e . for a more traditional editable package workflow inside an existing environment.
Next Steps
- Continue with Simulation Components for the local MuJoCo stack, assets, dynamics, and controllers.
- Continue with RL Tasks for Isaac Lab, Genesis Forge, and mjlab task workflows.
- Continue with Transfer and Deployment for Real2Sim, Sim2Sim, and Sim2Real workflows.
- Use the Development Guide for validation and contribution workflow.