2 · Installazione e avvio
Precedente: 01 PanoramicaSuccessivo: 03 Collegamento e calibrazione
Entrambi i metodi installano anche LeRobot — LeLab ne ha bisogno.
Metodo A · Comando unico
Richiede uv. Installa in un ambiente isolato:
uv tool install --with-executables-from huggingface_hub git+https://github.com/Juxi-Technology/leLab.git && lelabIl browser si apre su http://localhost:8000/.
Metodo B · Dai sorgenti
git clone https://github.com/Juxi-Technology/leLab.git
cd leLab
pip install -e .pip install -e . compila il front end React e lo impacchetta nel pacchetto Python, quindi un solo processo serve sia l'API sia l'interfaccia. La prima installazione richiede qualche minuto.
Se la build non trova Node.js, installa Node.js 22 e riprova. Node serve solo al momento dell'installazione e in modalità sviluppo — non per eseguire LeLab in seguito.
Vuoi invece il codice a monte? Questo repository è una copia. L'originale, mantenuto dal team LeRobot di Hugging Face, è https://github.com/huggingface/leLab. Tutto ciò che è descritto in queste pagine vale anche per esso, senza modifiche.
Avvio
lelabServe l'interfaccia su http://localhost:8000/ e apre il browser.
| Flag | Cosa fa |
|---|---|
lelab | Modalità produzione. Un processo serve l'API e l'interfaccia compilata su :8000 |
lelab --dev | Hot-reload Vite su :8080 più uvicorn --reload su :8000. Richiede Node.js 22 |
lelab --rebuild | Ricompila il front end dai sorgenti locali, poi avvia in modalità produzione |
lelab --no-open | Avvia senza aprire il browser |
lelab --stop | Ferma un LeLab in esecuzione e libera le porte 8000 e 8080 |
Ferma con Ctrl+C, oppure da un altro terminale:
lelab --stopUsa --stop quando la pagina smette di caricarsi: un processo rimasto attivo che occupa la porta 8000 o 8080 è la causa abituale.
Verifica che funzioni
Apri http://localhost:8000/. La pagina iniziale ha le schede Calibration, Teleoperation, Recording, Datasets, Training e Inference.
Dal terminale:
curl http://localhost:8000/healthRestituisce uno stato JSON.
Modalità sviluppo
lelab --devVite su :8080, l'API con auto-reload su :8000. Le modifiche sotto frontend/src/ aggiornano la pagina senza riavvio; le modifiche sotto lelab/ ricaricano il server.
In modalità --dev naviga su :8080, non su :8000. La porta 8000 ti dà l'API senza interfaccia.
Aggiornamento
LeLab controlla se il branch da cui è stato installato ha nuove commit e propone un aggiornamento nell'interfaccia. Per aggiornare manualmente:
uv tool install --with-executables-from huggingface_hub git+https://github.com/Juxi-Technology/leLab.git --forceLe installazioni modificabili (pip install -e .) sono escluse dal controllo. Aggiornale con git pull.
Successivo: 03 Collegamento e calibrazione