Mantieni Hermes Sempre Fresco: Aggiornare e Disinstallare reso Semplice

Mantenere aggiornato il tuo assistente AI non dovrebbe sembrare un’impresa da ingegneri missilistici. Per questo Hermes Agent lo rende un’operazione da un solo comando. Vediamo insieme tutto quello che devi sapere sugli aggiornamenti—e cosa succede dietro le quinte, così puoi aggiornare con totale tranquillità.

L’Aggiornamento con un Solo Comando

Aggiornare Hermes è semplice come:

hermes update

Tutto qui. Questo singolo comando scarica l’ultima versione del codice, aggiorna tutte le dipendenze e ti chiede persino informazioni sulle nuove opzioni di configurazione aggiunte dall’ultimo aggiornamento. Niente ricerche tra le note di rilascio, niente passaggi manuali—solo un comando pulito.

Cosa Succede Davvero Durante un Aggiornamento?

Ti starai chiedendo: “Cosa succede davvero sotto il cofano?” Ecco la spiegazione semplice dei sei passaggi che Hermes esegue per tenerti aggiornato:

Snapshot pre-aggiornamento — Prima che qualsiasi cosa cambi, Hermes salva uno snapshot leggero dei tuoi file di stato importanti (dati di associazione, cron job, configurazione e altro). I file oltre 1 GiB vengono saltati, così un database enorme non rallenta mai le operazioni. Questo snapshot viene creato per ogni profilo della tua installazione, dandoti una rete di sicurezza.
Git pull — Hermes scarica l’ultimo codice dal branch main e aggiorna eventuali sottomoduli.
Validazione sintattica post-pull + rollback automatico — Ecco la parte intelligente. Dopo il pull, Hermes verifica che tutti e nove i file critici vengano ancora analizzati correttamente. Se qualcosa sembra rotto (come un marcatore di conflitto di merge), esegue automaticamente il rollback alla versione precedente, così la tua shell rimane avviabile. Puoi semplicemente rieseguire l’aggiornamento una volta che la correzione arriva a monte.
Installazione dipendenze — Le dipendenze nuove o modificate vengono installate automaticamente.
Migrazione configurazione — Hermes rileva eventuali nuove opzioni di configurazione e ti chiede di impostarle. Hai perso il prompt? Nessun problema—basta eseguire hermes config check per vedere cosa manca, e poi hermes config migrate per aggiungerle in modalità interattiva.
Riavvio automatico del gateway — I gateway in esecuzione vengono aggiornati così il nuovo codice entra in vigore immediatamente. I gateway gestiti dal servizio si riavviano tramite il gestore dei servizi di sistema; quelli manuali si riavviano automaticamente.

Aggiornare da un Branch Diverso

A volte vuoi testare una release candidate o un branch di funzionalità. Hermes ti copre:

hermes update --branch release-candidate
hermes update --check --branch experimental   # solo per vedere quanto sei indietro

Se il tuo checkout locale è su un branch diverso, Hermes mette automaticamente da parte eventuali modifiche non committate, passa al branch di destinazione e fa il pull. I branch che non esistono localmente vengono tracciati automaticamente dal remoto. E se un branch non esiste da nessuna parte? Hermes fallisce in modo pulito e ripristina le modifiche messe da parte—non rimani mai bloccato.

E Se Sei Fermo su un Branch di Funzionalità?

Ti ritrovi su un branch di funzionalità? Hermes lo gestisce con eleganza:

Branch completamente mergiato — Hermes ti riporta su main e ti dice esattamente cosa è successo.
Commit non mergiati, albero pulito — L’aggiornamento procede comunque su main (importante per aggiornamenti non interattivi come il pulsante desktop), ma i tuoi commit restano intatti. Hermes stampa un avviso ben visibile con il nome del tuo branch e come tornarci.
Albero sporco (modifiche non committate) — Hermes non tocca il tuo lavoro. L’aggiornamento viene contrassegnato come SKIPPED con un avviso chiaro e i comandi esatti per risolvere la situazione.

Se mantieni deliberatamente un branch personalizzato, imposta updates.parked_branch_strategy: update_in_place nel tuo config.yaml. Hermes allora farà il merge di origin/main nel tuo branch invece di cambiare branch—i tuoi commit sopravvivono e il codice avanza.

Disinstallazione

Anche se l’aggiornamento è la star dello spettacolo, la disinstallazione è altrettanto semplice. Il processo rimuove Hermes in modo pulito dal tuo sistema, così puoi salutarlo senza lasciare disordine digitale.

Considerazioni Finali

Hermes Agent tratta gli aggiornamenti come un’esperienza di prima classe—sicura, reversibile e trasparente. Gli snapshot pre-aggiornamento, il rollback automatico sugli errori di sintassi e la gestione intelligente dei branch significano che puoi aggiornare con fiducia, sapendo che il tuo assistente continuerà a funzionare qualunque cosa accada.

Quindi vai avanti—esegui hermes update e lascia che il tuo assistente AI cresca con te. È il modo più semplice per restare all’avanguardia.