Coach
01
Riunisci i tuoi dati
Attività, sonno, frequenza cardiaca, VFC e recupero dall’orologio; calorie e nutrienti dall’app di dieta; peso e composizione corporea dalla bilancia impedenziometrica.
COACH / Guida completa
Il tuo piano e il monitoraggio, passo dopo passo.
Collega le fonti, definisci l’obiettivo, crea il piano con l’IA e portalo sull’orologio. La guida illustra monitoraggio, percorsi e impostazioni con schermate reali dell’app.
Schermate reali dell’app · ES / EN
Piano
COACH / Dai dati all’allenamento
Un ciclo completo. Il tuo allenamento, in contesto.
Il tuo obiettivo guida il piano. Allenamenti svolti, recupero, alimentazione ed evoluzione corporea danno contesto al monitoraggio e agli aggiustamenti proposti dall’IA.
02
Un piano adattato dall’IA
Obiettivo, sport, disponibilità e cronologia alimentano l’IA. Il piano definisce sessioni, intensità, riposo e obiettivi nutrizionali con i dati disponibili.
03
Il tuo piano, al polso.
Invia allenamenti compatibili a Garmin, Suunto o COROS* e segui la sessione sull’orologio sportivo.
04
Il monitoraggio chiude il cerchio
Allenamenti completati, riposo, dieta ed evoluzione del peso tornano a Coach. Confronta il previsto con i dati registrati e usa questo contesto nelle revisioni del piano con l’IA.
01 / Schermate
L’app, da vicino.
I moduli dell’app come appaiono su Android. Tocca una schermata per ingrandirla.
Schermate
Piano
Obiettivo, sport, disponibilità e cronologia alimentano l’IA. Il piano definisce sessioni, intensità, riposo e obiettivi nutrizionali con i dati disponibili.
Calendario
Rivedi le sessioni del piano e scopri nel calendario come allenamento e nutrizione si collegano ogni giorno.
Oggi
Sonno, cuore, recupero e movimento nella stessa vista.
Stato
Allenamenti completati, riposo, dieta ed evoluzione del peso tornano a Coach. Confronta il previsto con i dati registrati e usa questo contesto nelle revisioni del piano con l’IA.
Percorsi
Tiles © EsriScarica le tracce GPS disponibili delle attività e riunisci i percorsi sulla mappa di Coach.
I totali dei tuoi percorsi
Filtra per sport e periodo. Consulta numero di attività, distanza, dislivello positivo e calorie, per sport e nel totale del periodo.
Nutrizione
Energia e macronutrienti rispetto ai tuoi obiettivi giornalieri.
Composizione corporea
Peso, grasso, acqua e altre misure ricevute dalla bilancia, con la loro evoluzione.
Impostazioni
Otto pagine: Generale, Connessioni, IA, Coach, Tutorial, Copia, Simulazione e Informazioni. Obiettivo e IA si salvano quando un campo perde il focus o esci dall’app. Il manuale sotto percorre ogni pagina.
Schermate complete dell’app reale con dati reali. Passa dallo spagnolo all’inglese e ingrandisci un’immagine per vedere i dettagli.
02 / Piano
Un piano che comprende il tuo contesto.
Un piano adattato dall’IA
Obiettivo, sport, disponibilità e cronologia alimentano l’IA. Il piano definisce sessioni, intensità, riposo e obiettivi nutrizionali con i dati disponibili.
Il piano ha fasi, un orizzonte vicino con sedute dettagliate e date lontane ancora provvisorie. La chat parla di recupero, carico e pasti e può proporti una modifica da applicare al giorno. Una foto, uno scatto o un dettato sostituiscono solo il giorno futuro che hai scelto, dopo un’anteprima.
Dettagli dell’allenamento
Consulta obiettivo, riscaldamento, blocchi, ripetizioni e indicazioni dell’allenamento già pianificato.
Il monitoraggio chiude il cerchio
Allenamenti completati, riposo, dieta ed evoluzione del peso tornano a Coach. Confronta il previsto con i dati registrati e usa questo contesto nelle revisioni del piano con l’IA.
Mese e anno, con filtro per attività. Scegliendo un giorno vedi la valutazione: allenamento, calorie, proteine, carboidrati, grassi e sedute. In obiettivo, da sorvegliare e fuori obiettivo convivono con tre esiti distinti: riposo confermato, mancato rispetto e copertura sconosciuta. Dal dettaglio puoi annotare RPE, RIR, serie, ripetizioni e carico.
Dettagli dell’allenamento
Nutrizione
I registri dell’app di dieta forniscono calorie e macronutrienti quando vengono condivisi con Google Health connect.
Composizione corporea
La bilancia fornisce peso e le misure di bioimpedenza che pubblica. La loro evoluzione aggiunge contesto al piano e al monitoraggio.
Stato
Allenamenti completati, riposo, dieta ed evoluzione del peso tornano a Coach. Confronta il previsto con i dati registrati e usa questo contesto nelle revisioni del piano con l’IA.
La funzione di punta
Il tuo piano, al polso.
Segui il tuo piano di allenamento sull’orologio sportivo.
Attiva l’invio del piano nella connessione del produttore. Poi sincronizza Garmin Connect, Suunto o COROS con l’orologio per accedere alle sessioni compatibili e alle loro indicazioni.
* Questa connessione COROS consente di seguire sull’orologio solo corsa —incluso trail/ultra— e ciclismo. Palestra, forza, HIIT e altri sport restano in Coach e non vengono inviati a COROS come sessioni eseguibili.
Connessioni e compatibilità ↗Il tuo piano, al polso.
Schermate reali dell’app · ES / EN
04 / Percorsi
Le tue tracce, salvate in locale.
Scarica le tracce GPS disponibili delle attività e riunisci i percorsi sulla mappa di Coach.
I totali dei tuoi percorsi
Filtra per sport e periodo. Consulta numero di attività, distanza, dislivello positivo e calorie, per sport e nel totale del periodo.
Le tracce scaricate restano sul dispositivo. Puoi importare un GPX ed esportare un percorso dal dettaglio per salvarlo come file locale.
Il salvataggio locale della traccia non include una mappa completa offline: il download iniziale e le tessere della mappa possono richiedere rete.
Percorsi
Tiles © EsriI totali dei tuoi percorsi
AI / COACH
L’IA, a modo tuo.
L’IA usa il contesto disponibile per creare il piano e spiegare il monitoraggio. Scegli esecuzione locale, ibrida o remota in base al dispositivo e alle preferenze.
Locale
Nessuna inferenza esce dal telefono. Se manca il modello, si usano regole identificate oppure si indica che l’IA non è disponibile.
Ibrido
Piano, chat e riassunti di un periodo possono usare il fornitore remoto. Il coach del giorno, la valutazione e la spiegazione di un dettaglio restano locali.
Remoto
I compiti di inferenza usano il fornitore configurato. Se quel fornitore non è disponibile, può entrare un modello locale già scaricato.
Configura Coach con il tutorial
Apri Config → Tutorial → Ripeti tutorial. Segui questi passaggi per collegare i dati e creare il tuo primo piano.
-
01
Il tuo orologio
Scegli Garmin, Suunto o COROS per seguire i passaggi del produttore. Puoi iniziare anche senza orologio.
Il tuo orologio
-
02
Google Health connect
Consenti l’accesso a sonno, battito, attività, alimentazione e misure corporee condivisi dalle tue app e dai dispositivi.
Google Health connect
-
03
Collega il produttore
Accedi con l’account del tuo orologio. Controlla le opzioni per inviare il piano e il peso prima di continuare.
Collega il produttore
-
04
Scegli la tua IA
Seleziona l’IA sul telefono o nel cloud. Configura il modello e la chiave API, se richiesta dal fornitore.
Scegli la tua IA
-
05
Il tuo obiettivo e il piano
Descrivi il tuo obiettivo, imposta una data e scegli gli sport. Tocca “Crea il mio piano” e consulta le sessioni in Coach.
Il tuo obiettivo e il piano
Configurare ogni sezione separatamente
Tutte le impostazioni restano disponibili in Config. Puoi modificarle senza ripetere il tutorial.
Generale
Aspetto, lingua, voce, diagnosi di sincronizzazione e cancellazione dello storico.
-
1
Aspetto. Sistema, chiaro o scuro. Per impostazione segue il telefono.
-
2
Lingua. Automatica, oppure una di queste: spagnolo, inglese, portoghese del Brasile, francese, tedesco, italiano, cinese semplificato, hindi, russo e giapponese. Se la lingua di sistema non è nell’elenco, Automatica usa lo spagnolo. Per vedere il piano nella lingua nuova bisogna generarlo di nuovo.
-
3
Voce del coach. La velocità vale per tutta l’app. In spagnolo puoi scegliere una voce installata e ascoltare un campione.
-
4
Sincronizzazione. La diagnosi elenca ogni fonte. Garmin Connect si aggiorna da solo ogni 12 ore; dalla sua scheda puoi anche forzare metriche e GPX. Una sincronizzazione completa parte da questa pagina.
-
5
Dati e privacy. Da qui si apre il link dei permessi salute. Cancellare i dati locali elimina metriche, sonno, attività, analisi e piani. Connessioni e chiavi restano. La sincronizzazione resta in pausa finché non tocchi aggiorna, e l’invio del peso a Garmin si spegne.
Connessioni
Google Health connect, account degli orologi e chiave per tracciare i percorsi. Puoi avere più account collegati insieme.
-
1
Google Health connect. Installala o aggiornala, poi concedi i permessi. Coach legge soltanto. Possono arrivare attività, sonno, nutrizione, peso e gli altri tipi che l’app di origine pubblica e che tu permetti. Revocare un permesso non cancella ciò che è già salvato.
-
2
Garmin Connect. Accedi sul sito di Garmin. L’app cifra i token e non vede la password. Poi puoi sincronizzare le metriche, cercare i GPX mancanti e importare un file. Due interruttori, attivi solo con la sessione aperta: inviare il piano di 14 giorni al calendario e copiare peso e composizione di altre bilance.
-
3
COROS. Collega l’account, sincronizza e, se vuoi, pubblica gli allenamenti. Lo storico GPS arriva dal più recente all’indietro, con al massimo 50 file di attività al giorno. Foto, invio di percorsi all’orologio e peso non fanno parte di questa connessione.
-
4
Suunto. Accedi all’account dell’app Suunto. Si leggono allenamenti, sonno, attività quotidiana e il GPS disponibile. Le guide vanno all’orologio quando sincronizzi Suunto. Il peso non entra da qui. I testi hanno limiti: titolo del passo 13 caratteri, avviso 54, campo 40, nome della guida 60 e descrizione 256.
-
5
Percorsi con l’IA. Crea una chiave gratuita su openrouteservice.org e incollala qui. Senza chiave la chat può proporre un percorso e non può tracciarlo. Il massimo tracciabile è 100 km. L’invio a Garmin crea un corso privato in Garmin Connect.
-
6
Dieta, bilance e altri dispositivi. Devono condividere dati compatibili con Google Health connect. Autorizza la lettura in Coach. Ogni metrica dipende da ciò che pubblica l’app di origine.
| In pubblicazione | Cosa esegue l’orologio | Cosa resta testo |
|---|---|---|
| Garmin | Passi, giri e ripetizioni in forza e HIIT. | Obiettivi senza polso, ritmo o potenza misurati. Il nuoto in piscina finisce in «altro». |
| Suunto | Guida con tempi e campi compatibili. | Nomi degli esercizi, zone scritte come «Z2» e ripetizioni, che avanzano con Lap. |
| COROS* | Corsa, trail/ultra e ciclismo, con le loro sezioni. | * Questa connessione COROS consente di seguire sull’orologio solo corsa —incluso trail/ultra— e ciclismo. Palestra, forza, HIIT e altri sport restano in Coach e non vengono inviati a COROS come sessioni eseguibili. |
Body Battery, stress, carico e readiness di Garmin non escono da Google Health connect. Quelle letture dipendono dal fatto che l’origine le consegni per la propria via. Nel repository c’è un contratto di gateway per un server autorizzato con l’API salute di Garmin; questa app non include quel server.
IA
Prima scegli dove ragiona. Il fornitore remoto compare solo in ibrido e remoto. Cambiare modalità non cancella le chiavi.
-
1
Modalità. Locale, ibrido o remoto. La politica di ciascuna è nella sezione Dove ragiona.
-
2
Modello locale. Visibile in locale e ibrido. Il runtime gira in un altro processo. Gemma 4 E2B chiede circa 8 GB di RAM ed è il predefinito: testo, immagine e audio, su GPU o CPU. Gemma 4 E4B chiede 12 GB e solo GPU. LFM2.5 2.6B chiede circa 6 GB ed è testo. LFM2.5 1.2B chiede circa 4 GB, è testo e l’app non lo propone da sola. Download, annullamento e cancellazione stanno nella stessa scheda. Il profilo di velocità è automatico, qualità o rapido, e puoi misurare il modello sul telefono.
-
3
Fornitore remoto. OpenAI, Azure Foundry, Gemini, Claude, DeepSeek, OpenRouter o OpenCode. Ognuno conserva chiave, modello ed endpoint. Un campo vuoto usa il valore predefinito di quel fornitore. OpenRouter vuole l’identificatore completo, per esempio
openai/gpt-4.1-mini. OpenCode usa ID di Console, comeglm-5.3-flash; se lasci l’endpoint vuoto, l’app sceglie Chat Completions, Responses, Messages o Gemini secondo il modello. L’abbonamento OpenCode Go è un’altra API e non è quella che usa Coach. -
4
Chiave e prova. La chiave non viene più mostrata: vedi dei punti se ce n’è una salvata, e scrivere sostituisce la precedente. «Prova la connessione» salva prima il modulo ed esige una risposta vera. Una risposta tagliata, bloccata o senza testo finale viene rifiutata.
-
5
Immagini e audio. La scheda del modello dice se accetta le foto. Gemma 4 locale sì. Gli LFM del catalogo no, e la foto non viene dirottata a un altro fornitore. In ibrido, se il remoto scelto è solo testo e c’è un Gemma locale pronto, l’immagine può restare su quel Gemma. DeepSeek Flash accetta la visione; DeepSeek Pro no. L’audio locale di un’importazione dura fino a 30 secondi sul dispositivo.
La generazione del piano può continuare in background, con avviso e annullamento, per circa trenta minuti con la CPU sveglia. Il piano precedente resta finché il nuovo supera la validazione. Android può chiudere il processo: una richiesta remota interrotta non riparte da sola.
Coach
Ciò che l’app deve calcolare: l’obiettivo, gli sport, la strategia energetica e un peso di riferimento.
-
1
Obiettivo. Un testo libero fino a 3.000 caratteri: gara, infortuni, viaggi, giorni impossibili, attrezzatura, esperienza e come mangi. Descrizione e data decidono struttura, durata e dettaglio. Si salva quando il campo perde il focus.
-
2
Sport. Scegli quelli che pratichi. Il catalogo copre corsa, ciclismo, nuoto, multisport, palestra, outdoor, inverno, acqua, racchetta, squadra, combattimento e motore. Il piano e l’invio all’orologio usano questa selezione.
-
3
Energia. Automatica secondo l’obiettivo, mantenimento, deficit moderato o surplus moderato. Il peso base, tra 25 e 300 kg, serve a stimare quando l’orologio non ha ancora fornito abbastanza dispendio. Nel piano stesso ogni giorno indica se l’energia viene dallo storico dell’orologio, dal metabolismo basale, dal peso o dagli altri giorni del piano.
-
4
Genera piano. Il pulsante salva il modulo e avvia la generazione. Puoi uscire dalla schermata: l’avviso mostra la fase. Una generazione a metà può riprendere se dati, modello e politica coincidono. Rigenerare non riusa un piano già concluso.
Attrezzatura, limiti e preferenze alimentari stanno nel testo dell’obiettivo, non in caselle separate. I minuti di un altro sport non coprono la seduta prescritta.
Tutorial
Un percorso breve per lasciare l’app pronta: orologio, Google Health connect, IA e obiettivo. Puoi ripeterlo quando vuoi. Nel passo del modello l’app guarda la RAM del telefono e ne propone uno compatibile. La compatibilità reale dipende anche dalla memoria libera in quel momento.
Se hai già configurato tutto dalle altre pagine, il tutorial conferma soltanto lo stesso percorso.
Copia
-
1
Cosa include. Tutto il database: metriche, attività, sonno, nutrizione, piani, valutazioni, chat e tracce GPS, più il profilo dell’obiettivo. Restano fuori chiavi, sessioni dei produttori e la password della copia.
-
2
Password. Vuota: un file verificabile e leggibile. Con password: una busta AES-256-GCM. L’app non la ricorda. Serve la stessa per ripristinare.
-
3
Crea. Scegli la destinazione con il selettore documenti. Alla fine vedi il conteggio di righe e tabelle. Il file viene verificato mentre viene scritto.
-
4
Ripristina. Scegli il file e confermi. Formato, dimensione, integrità e tabelle si controllano prima di sostituire lo storico. Se qualcosa fallisce, si recupera il database precedente. Poi bisogna riavviare. La sincronizzazione resta in pausa e l’invio corporeo spento. Le credenziali di questo telefono si conservano. Il limite del file è 512 MiB.
Simulazione
Si attiva solo con l’app vuota: senza metriche, attività, percorsi, piani, pasti o sonno. Carica sei settimane di esempio — stato, sonno, allenamenti con percorsi, pasti e un piano — e mette in pausa tutte le sincronizzazioni. Una fascia ricorda che stai vedendo dati di esempio. All’uscita si cancella il database locale, compreso ciò che hai creato durante la simulazione, e le sincronizzazioni tornano.
Con dati reali di un orologio questa pagina resta chiusa di proposito.
Informazioni
Versione di questa guida: 1.1.23. Email dell’app: coach.ia.app@gmail.com.
Collega Garmin, Suunto o COROS*. Nutrizione e dati di bilance e altri dispositivi arrivano tramite Google Health connect quando la fonte li condivide e concedi i permessi.
La stima del sonno e la revisione del piano sono aiuti all’allenamento. Non sono un modello clinico né un predittore convalidato di infortunio.
Compilazione
Per chi genera l’app da questo repository. Servono JDK 17 e Android SDK Platform 36.
-
1
Controlli.
./gradlew :app:testDebugUnitTest :app:lintDebug :app:assembleDebug :app:assembleDebugAndroidTest -
2
Artefatti.
./gradlew :app:assembleRelease :app:bundleRelease. APK di debug:app/build/outputs/apk/debug/Coach-debug-1.1.23.apk. Release:Coach-1.1.23.apkeCoach-1.1.23.aab. -
3
Firma. La distribuzione usa la chiave di caricamento, fuori dal repository. Senza quella chiave la release compila con la firma di debug e Play non la accetta.
-
4
Schema. Room esporta gli schemi in
app/schemas. Il database vive nella memoria privata dell’app. Le preferenze delle chiavi usano Android Keystore. Il backup automatico di Android è disattivato.
I test che ricreano il database richiedono un pacchetto separato e un dispositivo usa e getta. Non fanno parte dell’uso quotidiano di un’installazione già configurata.
Cosa resta e cosa può uscire
Privato per impostazione. Esplicito quando qualcosa lascia il telefono.
Resta sul telefono
- Metriche, sonno, attività, percorsi, piani, valutazioni e la chat.
- Chiavi e sessioni, cifrate con Android Keystore.
- L’inferenza della modalità locale, comprese le foto che elabora Gemma.
- Il voto di aderenza, calcolato qui.
Esce solo se lo configuri
- Riassunti verso il fornitore di IA, in ibrido o remoto. La chat include il testo e riassunti di nutrizione e sonno. Le tracce GPS e le serie complete di polso non si allegano come track.
- Peso verso Garmin, con il suo interruttore.
- Allenamenti verso l’account Garmin, Suunto o COROS, con il suo interruttore.
- La zona visibile della mappa, verso il fornitore di tessere. Il file della copia, verso la destinazione che scegli.
Il dettaglio di archiviazione, destinazioni di rete e copie è in PRIVACY.md del repository. L’informativa pubblica collegata da Play è coach-ia-app.github.io/coach-privacy.