Installazione: App HA OS
Scegliere un metodo di installazione
Ci sono due modi per eseguire Superhome. Decidi quale si adatta alla tua configurazione, poi segui la guida corrispondente:
- All-in-one (questa guida). Tutto gira sull'host Home Assistant OS: inferenza, interfaccia web e integrazione con Home Assistant. È l'opzione più semplice e la scelta giusta per la maggior parte degli utenti, soprattutto per configurazioni su singolo host come un Pi 5 o un mini-PC con HAOS.
- Cluster master-worker. L'app Home Assistant resta il "master" (licenza, interfaccia Hub, integrazione HA) mentre una macchina separata esegue l'inferenza AI e ha la fotocamera collegata. Scegli questa opzione se il tuo host HA è troppo leggero per l'inferenza, oppure se vuoi tenere la fotocamera vicino a una macchina dedicata. Vedi Cluster Master-Worker.
I passaggi seguenti riguardano il metodo all-in-one.
Passaggi
1. Aggiungi il repository Superhome a Home Assistant
Superhome è distribuito come repository custom di Home Assistant. Lo aggiungi una sola volta e l'app apparirà poi nel tuo store.
1a. In Home Assistant, vai su Impostazioni → App → Installa app.
1b. Clicca sul menu a tre puntini (⋮) in alto a destra e scegli Repository.
1c. Incolla l'URL del repository di Superhome e clicca Aggiungi:
https://github.com/superhome-vision/superhome
1d. Chiudi la finestra di dialogo.
È necessario aggiungere il repository una sola volta. Da questo momento in poi, ogni futuro aggiornamento di Superhome apparirà automaticamente nello store.
2. Installa l'app
Ricarica la pagina dello store, scorri fino alla sezione Superhome, clicca sull'app e poi su Installa. La prima installazione scarica e decomprime l'immagine; prevedi circa 10 a 15 minuti a seconda dell'hardware e della velocità di internet. Questo avviene una sola volta.
3. Configura l'app
Apri la scheda Configurazione e inserisci almeno:
| Campo | Valore |
|---|---|
license_key | La tua chiave SH-XXXX-XXXX-XXXX-XXXX |
rtsp_url | Lo stream della fotocamera, es. rtsp://192.168.1.50:554/stream1 |
Clicca Salva.
4. Avvia l'app
Prima di avviare, apri la scheda Info e:
- Abilita il Watchdog in modo che Superhome si riavvii automaticamente se dovesse mai fermarsi.
- Facoltativamente abilita Mostra nella barra laterale per aprire l'Hub di Superhome direttamente dal menu di Home Assistant.
Ora clicca Avvia. Il primo avvio impiega circa un minuto per essere pronto. Una volta avviato, clicca Apri UI web per accedere all'Hub, oppure apri Superhome dalla barra laterale se hai abilitato il pannello laterale.
L'Hub è accessibile solo dall'interno di Home Assistant (tramite il pannello ingress dell'app o la voce nella barra laterale). Non c'è alcun URL o porta da ricordare.
Prossimo passo
→ Configura la fotocamera per ottenere il corretto URL RTSP.
→ Vuoi spostare l'inferenza su una macchina dedicata? Vedi Cluster Master-Worker.