Tutorial 3: Percorso di Apprendimento — La Tua Roadmap verso la Padronanza

Pensa a Hermes Agent come a un coltellino svizzero: può fare un sacco di cose diverse, ma non devi impararle tutte in una volta. Questo percorso di apprendimento è come una mappa che ti mostra la via più breve da “l’ho appena installato” a “sto costruendo i miei strumenti personalizzati”.

Passo 1: Inizia Qui (Principiante — ~1 ora)

Se non hai ancora installato Hermes Agent, smetti di leggere e fallo prima. Esegui questi due comandi nel tuo terminale:

# Installa Hermes Agent
pip install hermes-agent

# Configura il tuo primo provider (un solo comando copre tutto!)
hermes setup --portal

Il flag --portal è una scorciatoia magica. Ti dà un unico accesso che sblocca il modello AI più quattro strumenti integrati: ricerca web, generazione di immagini, sintesi vocale e un browser. Non devi configurare cinque account diversi — solo uno.

Dopo di che, segui questo ordine di lettura:

1. Avvio rapido — fai partire la tua prima conversazione
2. Uso da CLI — impara a parlare con Hermes nel tuo terminale
3. Configurazione — regola le impostazioni in base alle tue preferenze

Alla fine di questo passo, avrai un assistente AI funzionante che può rispondere a domande ed eseguire semplici comandi.

Passo 2: Sali di Livello (Intermedio — ~2–3 ore)

Ora che hai dimestichezza con le basi, è il momento di far lavorare Hermes per te. È qui che le cose si fanno divertenti.

1. Sessioni — scopri come Hermes ricorda il contesto tra le conversazioni
2. Messaggistica — collega Hermes a Telegram o Discord per chattare dal tuo telefono
3. Strumenti — esplora tutte le funzionalità integrate (ricerca, immagini, browser e altro)
4. Skill — insegna a Hermes nuovi trucchi creando pacchetti di skill riutilizzabili
5. Memoria — lascia che Hermes ricordi informazioni su di te e sui tuoi progetti nel tempo
6. Cron — pianifica attività da eseguire automaticamente, come un briefing mattutino quotidiano

Il comando chiave qui è:

# Avvia una nuova sessione con una skill specifica caricata
hermes --skill my-custom-skill

Questa è anche la fase in cui vorrai configurare i tuoi bot di messaggistica. La documentazione include guide complete sia per Telegram che per Discord, oltre a progetti di esempio come un bot di briefing quotidiano che ti invia le notizie ogni mattina.

Passo 3: Vai in Profondità (Avanzato — ~4–6 ore)

È qui che diventi un power user. Non stai più solo usando Hermes — lo stai estendendo.

1. Architettura — capisci come è costruito Hermes sotto il cofano
2. Aggiungere Strumenti — scrivi le tue funzioni Python che Hermes può chiamare
3. Creare Skill — impacchetta i tuoi strumenti personalizzati e i prompt in skill condivisibili
4. Contribuire — invia i tuoi miglioramenti al progetto open source

Un semplice strumento personalizzato funziona così:

from hermes import tool

@tool
def get_weather(city: str) -> str:
    """Get current weather for a city."""
    # Your code here
    return f"Weather in {city}: sunny, 72°F"

Una volta scritto questo, Hermes può chiamare automaticamente la tua funzione quando qualcuno chiede informazioni sul meteo. Nessuna integrazione complessa necessaria.

La Tua Roadmap Personale

Ecco la verità onesta: non devi leggere tutto. Scegli il tuo obiettivo:

• Vuoi solo un assistente da terminale? Fai il Passo 1 e fermati.
• Vuoi un bot Telegram? Fai il Passo 1 + Passo 2 (sezioni Messaggistica + Voce).
• Vuoi automatizzare la tua vita? Fai il Passo 1 + Passo 2 (sezioni Cron + Memoria).
• Vuoi costruire qualcosa di nuovo? Fai tutti e tre i passi.

La documentazione è organizzata in modo da poter saltare da una parte all’altra. La tabella sulla pagina ufficiale ti dà anche delle stime di tempo — la maggior parte delle persone completa il Passo 1 in meno di un’ora.

Riepilogo

Pensa a questo percorso di apprendimento come all’imparare a cucinare: prima impari a bollire l’acqua (Passo 1), poi segui le ricette (Passo 2), e infine inventi i tuoi piatti (Passo 3). Inizia in piccolo, costruisci fiducia ed espanditi quando sei pronto.

Prossimo passo: Nel Tutorial 4, manterremo Hermes aggiornato — aggiornamento e disinstallazione pulita, con una rete di sicurezza integrata.

---