Hermes sul tuo Android? Sì, si può fare!

Probabilmente avrai sentito che Hermes Agent funziona benissimo su desktop o server. Ma cosa succede se vuoi eseguire un agente AI direttamente dalla tasca? Buone notizie: Hermes ora funziona su telefoni Android tramite Termux. Non è l’esperienza desktop completa, ma è un agente CLI solido e nativo per il telefono, in grado di gestire cron job, messaggistica e altro ancora.

Vediamo cosa funziona, cosa non funziona e come iniziare.

Cosa Funziona su Android (Il Percorso Testato)

Il bundle ufficiale per Termux installa queste funzionalità principali:

Hermes CLI — l’agente completo da riga di comando
Supporto Cron — pianifica attività automaticamente
Supporto PTY/terminale in background — esegui agenti in background
Gateway Telegram — chatta con il tuo agente tramite Telegram (best-effort)
Supporto MCP — connetti strumenti esterni
Memoria Honcho — memoria persistente tra le sessioni
Supporto ACP — protocollo di comunicazione tra agenti

Il comando di installazione testato è:

python -m pip install -e '.[termux]' -c constraints-termux.txt

Cosa NON è Ancora Supportato

Alcune funzionalità richiedono dipendenze desktop/server che non sono disponibili su Android:

L’extra completo .[all] non è supportato
Voce è bloccata perché ctranslate2 non pubblica wheel per Android
Il bootstrap automatico di Browser/Playwright viene saltato
L’isolamento Docker non è disponibile dentro Termux
Android potrebbe sospendere i processi in background, quindi la persistenza del gateway è best-effort

Niente paura — Hermes funziona comunque benissimo come agente CLI nativo per il telefono. È semplicemente volutamente più limitato rispetto all’installazione desktop.

Opzione 1: Installer a Una Riga (Il Più Semplice)

Hermes ora include un installer che riconosce Termux e gestisce tutto automaticamente:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Su Termux, l’installer automaticamente:

Usa pkg per i pacchetti di sistema
Crea un ambiente virtuale Python
Prova prima l’extra ampio .[termux-all], poi ripiega su .[termux]
Collega hermes in $PREFIX/bin così rimane nel tuo PATH
Salta il bootstrap non testato di browser/WhatsApp

Se vuoi più controllo o devi fare debug, usa il percorso manuale qui sotto.

Opzione 2: Installazione Manuale (Totalmente Esplicita)

1. Aggiorna Termux e installa i pacchetti di sistema

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

Perché questi? clang, rust, make, pkg-config, libffi e openssl servono per compilare le dipendenze Python su Android. ripgrep fornisce una ricerca file veloce, e ffmpeg gestisce le conversioni multimediali.

2. Clona Hermes

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

3. Crea un ambiente virtuale

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel

L’export di ANDROID_API_LEVEL è importante per i pacchetti basati su Rust come jiter.

4. Installa il bundle testato per Termux

python -m pip install -e '.[termux]' -c constraints-termux.txt

Vuoi solo l’agente minimo? Anche questo funziona:

python -m pip install -e '.' -c constraints-termux.txt

5. Metti `hermes` nel tuo PATH

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

Questo rende disponibile il comando hermes in ogni nuova shell senza dover riattivare il venv.

6. Verifica l’installazione

hermes --version
hermes doctor

7. Avvia Hermes

hermes

Opzione APT Mantenuta dalla Community

Preferisci un gestore pacchetti nativo? È disponibile un repository APT mantenuto dalla community. Nota: Non è una distribuzione ufficiale NousResearch — ti fidi di un repository gestito da un contributore e della sua chiave di firma.

curl -fsSL https://raw.githubusercontent.com/adybag14-cyber/termux-python/main/scripts/setup_apt_repo.sh | bash
pkg install hermes-agent

L’impronta della chiave di firma è:

EAD24A2124EFA7393A78B7B14699F966313F7A6B

Con le installazioni APT, Hermes non eseguirà il suo auto-aggiornamento Git. Usa invece il gestore pacchetti:

pkg update
pkg upgrade hermes-agent

Configurazione Consigliata Dopo l’Installazione

Configura un modello

hermes model

Oppure imposta le chiavi direttamente in ~/.hermes/.env.

Riesegui la procedura guidata quando vuoi

hermes setup

Considerazioni Finali

Eseguire Hermes sul tuo telefono Android è un ottimo modo per avere un agente AI sempre a portata di mano. Non è l’esperienza desktop completa, ma per cron job, chat Telegram e attività da CLI, è sorprendentemente capace. Inizia con l’installer a una riga e, se incontri problemi, il percorso manuale ti dà il controllo totale. Buona automazione!