Use uv for bisection runtime bootstrap

Select a supported Python version independently of the host default so the
clean-clone Skill workflow works on systems that still provide Python 3.10.

Author: Horde

skills/developer/perf-bisection/SKILL.md

@@ -33,7 +33,7 @@ This Skill contains instructions, not the executable runtime. Before starting:
 2. Prefer the repository-local executables
    `$REPO_ROOT/.venv-bisection/bin/isaaclab-bisect` and
    `$REPO_ROOT/.venv-bisection/bin/isaaclab-bisect-skill`.
-3. If they are absent, show the two local installation commands in the
+3. If they are absent, show the repository-local installation plan in the
    [runtime bootstrap](reference.md#runtime-bootstrap) and obtain one explicit
    confirmation before creating the environment or installing the package.
 4. Verify both executables with `--help`, then use their exact paths for the

skills/developer/perf-bisection/evaluations.md

@@ -138,18 +138,21 @@ Known failure modes:
 
 ## Scenario 9: Runtime Is Not Installed
 
-Query: "Bisect this regression from my Isaac Lab checkout."
+Query: "Bisect this regression from my Isaac Lab checkout; system python3 is
+3.10."
 
 Expected behavior:
 
 - Detects `tools/perf_bisection/pyproject.toml`.
 - Shows the repository-local virtual-environment installation plan.
+- Uses `uv` to select Python 3.12 instead of the incompatible system Python.
 - Obtains confirmation before installing and verifies both executables.
 - Uses `.venv-bisection/bin/isaaclab-bisect` for the run.
 
 Known failure modes:
 
 - Assumes `isaaclab-bisect` is already on `PATH`.
+- Creates an unusable environment from the system's Python 3.10.
 - Installs packages or builds a container without confirmation.
 
 ## Scenario 10: Skill Installed Without Isaac Lab

skills/developer/perf-bisection/reference.md

@@ -31,12 +31,16 @@ If either executable is missing, show this plan and obtain one confirmation
 before running it:
 
 ```bash
-python3 -m venv "$REPO_ROOT/.venv-bisection"
-"$REPO_ROOT/.venv-bisection/bin/python" -m pip install "$REPO_ROOT/tools/perf_bisection"
+uv venv --python 3.12 --clear "$REPO_ROOT/.venv-bisection"
+uv pip install \
+    --python "$REPO_ROOT/.venv-bisection/bin/python" \
+    "$REPO_ROOT/tools/perf_bisection"
 "$REPO_ROOT/.venv-bisection/bin/isaaclab-bisect" --help
 "$REPO_ROOT/.venv-bisection/bin/isaaclab-bisect-skill" --help
 ```
 
+If `uv` is unavailable, stop and route host onboarding through the official
+Isaac Lab installation workflow. Do not fall back to a pre-3.11 system Python.
 Use these exact repository-local executable paths afterward. For
 `docker-reconstruct`, also check for the selected image with
 `docker image inspect`. If it is absent, obtain confirmation before building it

tools/perf_bisection/README.md

@@ -19,22 +19,23 @@ integration point.
 
 ## Install from Isaac Lab
 
-The agent is maintained inside the Isaac Lab repository. Python 3.11 or newer
-is required. Use a virtual environment on distributions such as Ubuntu 24.04
-that protect the system Python environment. Minimal Ubuntu installations may
-need the distribution's `python3-venv` package first:
+The agent is maintained inside the Isaac Lab repository and requires Python
+3.11 or newer. Use Isaac Lab's standard `uv` tooling to select Python 3.12
+independently of the host's default `python3`:
 
 ```bash
-python3 -m venv .venv-bisection
-.venv-bisection/bin/python -m pip install ./tools/perf_bisection
+uv venv --python 3.12 .venv-bisection
+uv pip install --python .venv-bisection/bin/python ./tools/perf_bisection
 .venv-bisection/bin/isaaclab-bisect --help
 ```
 
 For development:
 
 ```bash
-python3 -m venv .venv-bisection
-.venv-bisection/bin/python -m pip install --editable "./tools/perf_bisection[test]"
+uv venv --python 3.12 .venv-bisection
+uv pip install \
+    --python .venv-bisection/bin/python \
+    --editable "./tools/perf_bisection[test]"
 ```
 
 Real benchmark runs require Linux, Git, an NVIDIA GPU/driver compatible with the

tools/perf_bisection/docs/development.md

@@ -13,9 +13,9 @@ From the Isaac Lab repository root, create an environment with Python 3.11 or
 newer, then install the package:
 
 ```bash
-python3 -m venv .venv-bisection
+uv venv --python 3.12 .venv-bisection
 source .venv-bisection/bin/activate
-python -m pip install --editable "./tools/perf_bisection[test]"
+uv pip install --python .venv-bisection/bin/python --editable "./tools/perf_bisection[test]"
 ```
 
 Run the CPU-only validation:

tools/perf_bisection/docs/releasing.md

@@ -43,9 +43,9 @@ Before announcing a release to other developers, validate from a new clone on a
 host that does not have the source checkout on `PYTHONPATH`:
 
 ```bash
-python3 -m venv /tmp/isaaclab-bisect-release
+uv venv --python 3.12 /tmp/isaaclab-bisect-release
 source /tmp/isaaclab-bisect-release/bin/activate
-python -m pip install ./tools/perf_bisection
+uv pip install --python /tmp/isaaclab-bisect-release/bin/python ./tools/perf_bisection
 isaaclab-bisect --help
 ```