Files
lerobot_learn/env/setup_lerobot.sh
T

101 lines
4.6 KiB
Bash

#!/usr/bin/env bash
# Ubuntu x86_64 GPU hosts. First host: --resolve; second host: same lock.
set -Eeuo pipefail
trap 'printf "ERROR at line %s: environment NOT verified.\n" "$LINENO" >&2' ERR
SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
WORKDIR="${ROBOT_WORKDIR:-${HOME}/robot}"
VENV="${WORKDIR}/.venv-lerobot-0.6.1"
LOCK="${SCRIPT_DIR}/requirements-linux-py312.lock"
INPUT="${SCRIPT_DIR}/requirements.in"
RESOLVE=false
case "${1:-}" in
--resolve) RESOLVE=true ;;
--help) echo "Usage: bash $0 [--resolve] (Linux x86_64, uv, NVIDIA driver, ffmpeg)"; exit 0 ;;
"") ;;
*) echo "Unknown argument: $1" >&2; exit 2 ;;
esac
[[ $# -le 1 ]] || { echo "Too many arguments" >&2; exit 2; }
[[ "$(uname -s)" == Linux && "$(uname -m)" == x86_64 ]] || {
echo "Only Linux x86_64 GPU hosts are supported; RPi needs a separate environment." >&2; exit 1;
}
for cmd in uv nvidia-smi ffmpeg sha256sum gcc; do
command -v "$cmd" >/dev/null || { echo "Missing prerequisite: $cmd" >&2; exit 1; }
done
if ! $RESOLVE && [[ ! -s "$LOCK" ]]; then
echo "Missing lock: use --resolve on 3080 first; transfer the validated lock and .input.sha256 to 3090." >&2; exit 1
fi
if $RESOLVE && [[ -e "$LOCK" || -e "$LOCK.input.sha256" ]]; then
echo "Refusing to overwrite existing lock. Review and archive it before an intentional update." >&2; exit 1
fi
mkdir -p "$WORKDIR"
REPORT="${WORKDIR}/reports/$(date -u +%Y%m%dT%H%M%SZ)-$$"
mkdir -p "$REPORT"
exec > >(tee "$REPORT/setup.log") 2>&1
echo "[1/5] Prerequisites"
nvidia-smi --query-gpu=name,memory.total,driver_version --format=csv,noheader
uv --version
cat /etc/os-release > "$REPORT/os-release.txt"
uname -srmo > "$REPORT/kernel.txt"
nvidia-smi > "$REPORT/nvidia-smi.txt"
ffmpeg -version > "$REPORT/ffmpeg.txt"
# Set UV_DEFAULT_INDEX explicitly if a mirror is needed. No automatic Hub/token routing.
echo "[2/5] Dedicated Python 3.12 environment"
if [[ ! -d "$VENV" ]]; then uv venv --python 3.12 "$VENV"; fi
PYTHON="${VENV}/bin/python"
"$PYTHON" -c 'import sys; assert sys.version_info[:2] == (3, 12), sys.version'
PYTHON_INCLUDE="$("$PYTHON" -c 'import sysconfig; print(sysconfig.get_path("include"))')"
[[ -f "$PYTHON_INCLUDE/Python.h" ]] || {
echo "Missing Python development headers: $PYTHON_INCLUDE/Python.h" >&2; exit 1;
}
if $RESOLVE; then
TEMP_LOCK="$(mktemp "${LOCK}.tmp.XXXXXX")"
trap 'rm -f -- "$TEMP_LOCK"' EXIT
uv pip compile "$INPUT" --python "$PYTHON" --generate-hashes --output-file "$TEMP_LOCK"
mv -- "$TEMP_LOCK" "$LOCK"
(cd "$SCRIPT_DIR" && sha256sum requirements.in) > "$LOCK.input.sha256"
trap - EXIT
fi
[[ -s "$LOCK.input.sha256" ]] || { echo "Missing input fingerprint" >&2; exit 1; }
(cd "$SCRIPT_DIR" && sha256sum --check "${LOCK}.input.sha256")
echo "[3/5] Install locked packages (dedicated venv only)"
uv pip sync --python "$PYTHON" --require-hashes "$LOCK"
uv pip check --python "$PYTHON"
echo "[4/5] GPU, policy implementations, video libraries and CLI"
"$PYTHON" - <<'PY'
import importlib
import importlib.metadata
import torch
assert importlib.metadata.version('lerobot') == '0.6.1'
assert torch.cuda.is_available(), 'CUDA unavailable: check driver and torch build'
x = torch.ones((32, 32), device='cuda')
assert (x @ x).sum().item() == 32768
torch.cuda.synchronize()
print('torch:', torch.__version__, 'CUDA:', torch.version.cuda, 'GPU:', torch.cuda.get_device_name(0))
for module in (
'lerobot.policies.act.modeling_act',
'lerobot.policies.smolvla.modeling_smolvla',
'lerobot.robots.so_follower',
'lerobot.teleoperators.so_leader',
'av', 'torchcodec',
):
importlib.import_module(module)
print('OK:', module)
PY
for cli in lerobot-find-port lerobot-find-cameras lerobot-setup-motors lerobot-calibrate lerobot-teleoperate lerobot-record lerobot-train lerobot-rollout; do
[[ -x "$VENV/bin/$cli" ]] || { echo "Missing CLI: $cli" >&2; exit 1; }
done
# find-port ignores --help and starts an interactive USB discovery procedure.
# Discovery tools are checked for existence only; never invoke them in setup.
for cli in lerobot-setup-motors lerobot-calibrate lerobot-teleoperate lerobot-record lerobot-train lerobot-rollout; do
"$VENV/bin/$cli" --help > "$REPORT/$cli-help.txt" 2>&1
done
echo "[5/5] Save verification evidence"
uv pip freeze --python "$PYTHON" > "$REPORT/packages.txt"
"$PYTHON" -VV > "$REPORT/python.txt"
sha256sum "$LOCK" > "$REPORT/lock.sha256"
cp -- "$LOCK" "$LOCK.input.sha256" "$REPORT/"
echo "PASS: software smoke checks only; recording, model training and robot safety remain unverified."
echo "Report: $REPORT"
printf 'Activate: source %q/bin/activate\n' "$VENV"
echo "Use hf auth login only if accessing the Hub; use the official endpoint for authenticated uploads."