Profili Hermes: separare gli agenti personali e di lavoro

Questa guida presuppone che Hermes sia già installato e che tu stia lavorando dal terminale. Se il comando hermes non è ancora eseguibile, inizia da installazione e configurazione iniziale di Hermes Agent. I nomi personal e work riportati di seguito sono esempi illustrativi, non le impostazioni di lavoro effettive di qualcuno.

Puoi trovare ulteriori istruzioni nella documentazione di Ailoot.

Quando serve un secondo profilo#

Un profilo è una cartella separata che contiene le impostazioni e i dati di Hermes. Include config.yaml, il file delle chiavi .env, le istruzioni SOUL.md, la memoria, le sessioni, le competenze e le attività pianificate. Un agente è un assistente in esecuzione che usa questi dati.

Supponiamo che ti serva un insieme di preferenze per le attività personali e un altro per quelle di lavoro. I profili separati ti consentono di archiviarli separatamente. Se cambia solo la domanda, mentre le impostazioni e la memoria devono rimanere condivise, non è necessario creare un profilo per ogni conversazione.

Usa profili diversi per due agenti che lavorano in modo indipendente. La documentazione ufficiale avverte che due processi agente che usano la stessa cartella del profilo possono accumulare memoria condivisa e riprendere le voci l'uno dell'altro all'avvio delle sessioni.

Cosa separa un profilo e cosa non protegge#

OAuth significa accedere tramite un account del provider. La documentazione spiega separatamente gli accessi condivisi per Anthropic, OpenAI Codex e xAI: una clonazione completa non copia i token di aggiornamento monouso come credenziali separate e indipendenti. Se un profilo ha bisogno del proprio accesso OAuth, configuralo separatamente.

Neanche la cartella di lavoro costituisce un confine di protezione. Il parametro terminal.cwd imposta la cartella da cui partono i comandi, ma non impedisce l'accesso ad altre directory. Un'istruzione in SOUL.md come «non entrare nella cartella personale» guida il comportamento del modello, ma non impone una restrizione di accesso. Se l'obiettivo specifico è proteggere i file, separare i profili da solo non basta.

I profili aiutano a mantenere separato il contesto in base all'attività.

Verifica i nomi esistenti prima di creare i profili#

Apri il terminale ed esegui:

hermes profile list
hermes profile

Il primo comando elenca i profili; il secondo mostra il profilo corrente, il relativo percorso, il modello e lo stato della connessione al messenger. Se personal o work esiste già, verifica prima di quale profilo si tratta:

hermes -p personal profile
hermes -p work profile

Non eliminare un profilo esistente per liberare un nome per l'esempio. Scegli altri nomi disponibili e usali in ogni comando successivo. Questa guida presuppone che entrambi i nomi siano disponibili.

Ti servirà l'accesso al provider del modello selezionato per configurare ciascun profilo. La creazione di una cartella non conferma che il modello sia connesso. Non copiare le chiavi in una conversazione e non chiedere all'agente di mostrare il contenuto di .env per verificarlo.

Crea due profili senza clonare#

Esegui i comandi uno dopo l'altro:

hermes profile create personal
hermes profile create work

Senza opzioni aggiuntive, Hermes crea profili nuovi con un insieme integrato di competenze, quindi le relative cartelle non saranno vuote. Le chiavi, il modello e le connessioni al messenger si configurano nel passaggio successivo.

Non aggiungere --clone per velocizzare questa guida. Questa opzione copia non solo le impostazioni del profilo corrente, ma anche le istruzioni, le competenze e i file di memoria memories/MEMORY.md e memories/USER.md. La clonazione non è adatta a separare il contesto personale e quello di lavoro partendo da zero.

Quando cloni, controlla anche le impostazioni dei servizi di memoria esterna. Per esempio, la documentazione avverte che una configurazione di memoria esterna clonata in modalità local_embedded continua a usare il processo e il banco di memoria originali finché la copia non viene configurata con un proprio profile e bank_id. Creare un nuovo nome non corregge automaticamente questa configurazione condivisa.

Verifica che i profili siano stati creati:

hermes profile list
hermes -p personal profile
hermes -p work profile

Entrambi i nomi dovrebbero apparire nell'elenco e i relativi dettagli dovrebbero mostrare percorsi diversi. In un'installazione standard, sono ~/.hermes/profiles/personal/ e ~/.hermes/profiles/work/. Il simbolo ~ rappresenta la cartella home dell'utente. Con un valore HERMES_HOME non standard, usa il percorso effettivo riportato dal comando invece di questo esempio.

Configura il modello separatamente e avvia esplicitamente il profilo che ti serve#

Configura prima il profilo personale, poi quello di lavoro:

hermes -p personal setup
hermes -p work setup

Completa la procedura guidata di configurazione per ciascuno. Le impostazioni del modello e del provider sono archiviate nel config.yaml del profilo corrispondente e le chiavi nel relativo .env. Questo non garantisce che tutti gli accessi siano indipendenti: gli accessi OAuth e gli account nei programmi esterni possono rimanere condivisi, come indicato nella tabella sopra.

Dopo la configurazione, apri la chat personale:

hermes -p personal chat

Avvia la chat di lavoro con un comando diverso:

hermes -p work chat

All'avvio, controlla la riga Profile: personal o Profile: work; anche il prompt dei comandi mostra il nome del profilo. Non eseguire due agenti che lavorano in modo indipendente con lo stesso -p.

Hermes crea un comando breve per un profilo, come personal chat. Qui usiamo la forma completa con -p, così la scelta è visibile direttamente nel comando. Non è necessario cambiare ogni volta il profilo predefinito quando avvii una chat.

Il comando hermes profile use work ha un effetto diverso: le successive chiamate semplici a hermes selezioneranno work all'avvio. Se lo hai già usato e vuoi ripristinare il profilo standard, esegui:

hermes profile use default

Come verificare il risultato senza dati personali#

Per prima cosa controlla lo stato tramite Hermes stesso, invece di chiedere al modello «sei proprio l'agente di lavoro?».

Poi puoi eseguire una verifica illustrativa del comportamento: in una nuova conversazione personale, chiedi un elenco di cose da portare a passeggio e, in una conversazione di lavoro, chiedi un piano per revisionare un documento. Non usare dati reali. Le sole risposte diverse non dimostrano l'isolamento; questa verifica stabilisce soltanto che entrambe le chat si avviano e rispondono. Confronta il risultato con il profilo selezionato e la relativa cartella.

Se dopo la configurazione ti servono procedure di lavoro diverse, aggiungile al profilo appropriato. L'ordine per installare e creare competenze è spiegato nella guida alle competenze di Hermes Agent.

Errori che fanno sì che il contesto torni a essere condiviso#

Il profilo è stato creato con --clone. Potrebbe esservi stata copiata la vecchia memoria integrata. Non eliminarla alla cieca: controlla prima come è stato creato il profilo e i file nel profilo in questione. Per ripetere la guida partendo da zero, usa un nuovo nome disponibile senza opzioni di clonazione.

Avviare hermes senza argomenti e dimenticare il profilo predefinito. Controlla hermes profile e usa un -p personal o -p work esplicito nei comandi di avvio.

Profili diversi usano la stessa memoria esterna. Controlla le impostazioni del servizio stesso. I suoi dati non devono necessariamente essere separati come i file locali di Hermes; l'esempio sopra illustra esattamente questo problema.

Due profili usano lo stesso bot messenger. Configura token bot diversi per connessioni indipendenti. Un token identifica il bot della piattaforma, mentre il nome del profilo identifica i dati di Hermes; cambiare l'uno non crea l'altro. La connessione è spiegata in dettaglio nella guida a Telegram per Hermes Agent.

Aspettarsi che un profilo impedisca di leggere altre cartelle. Con l'esecutore locale, i diritti di accesso rimangono quelli dell'utente del sistema operativo. Né il nome work, né un SOUL.md separato, né una cartella di lavoro sostituiscono le restrizioni del file system.

Inizia con due profili nuovi senza clonazione e seleziona esplicitamente il profilo all'avvio. Collega i dati di lavoro dopo aver verificato i nomi e i percorsi, e controlla separatamente la memoria esterna, i bot e gli account. Per il passaggio successivo nel lavoro con l'IA, consulta la documentazione di Ailoot.

Documentazione ufficiale#

Profili Hermes Agent: creazione, passaggio e limiti di separazione. Questa guida è stata verificata il 24 settembre 2026 confrontandola con questa versione fissata del documento ufficiale.

Per continuare a lavorare con i modelli, puoi andare su Ailoot.