4d • AI Tools
🛸 Hermes Agent — Guida all'Installazione Portatile
> Esegui un agente AI completamente autonomo e auto-migliorante da una singola cartella o chiavetta USB.
> Nessuna installazione globale. Zero modifiche al sistema. Tutto rimane dentro la tua cartella.
📥 **Download del progetto:** [github.com/techtonic2025/Hermes-USB-Portable](https://github.com/techtonic2025/Hermes-USB-Portable)
---
## ✨ Cosa puoi fare con Hermes Portable
- Avviare un agente AI completo **senza installare Python o Node.js** sul computer
- Portarlo su **qualsiasi PC, Mac o Linux** semplicemente copiando la cartella
- Mantenere **conversazioni, memorie e configurazioni** al sicuro nella tua cartella privata
- Usare provider come **OpenRouter, OpenAI e Anthropic** tramite le tue API key
- Aggiornare Hermes all'ultima versione direttamente dalla chat
---
## ⚡ Avvio Rapido
### Windows 10 / 11
1. Scarica o clona il repository da GitHub
2. Apri la cartella `hermes-portable`
3. Fai **doppio clic** su `launch.bat`
> Al primo avvio si aprirà una finestra PowerShell per scaricare le dipendenze (~600 MB). Attendere il completamento.
---
### macOS e Linux
1. Apri il Terminale nella cartella del progetto
2. Esegui:
```bash
chmod +x launch.sh
./launch.sh
```
> **Scorciatoia macOS:** Rinomina `launch.sh` in `launch.command` per poter fare doppio clic dal Finder.
---
## 🗝️ Configurare le API Key
Apri il file `data/.env` con un editor di testo e incolla le tue chiavi:
```env
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxx
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
```
In alternativa, seleziona l'opzione **`[2] Setup / Riconfigura`** nel menu del launcher per configurarle in modo interattivo.
---
## 📁 Struttura della Cartella
```
hermes-portable/
├── launch.bat ← Avvio per Windows
├── launch.sh ← Avvio per macOS/Linux
├── scripts/ ← Script di setup automatico
├── data/ ← ⚠️ FANNE UN BACKUP — i tuoi dati privati
│ ├── config.yaml ← Configurazione del modello LLM
│ ├── .env ← Le tue API key
│ ├── sessions/ ← Storico delle conversazioni
│ ├── memories/ ← Memoria persistente dell'agente
│ └── skills/ ← Skill personalizzate apprese
├── src/hermes-agent/ ← Codice sorgente di Hermes
└── .cache/runtimes/ ← Python e Node.js portatili (auto-scaricati)
```
> La cartella `data/` contiene tutto ciò che è tuo: tienila al sicuro e fanne backup periodici.
---
## 🖥️ Sistemi Operativi Supportati
| Sistema Operativo | Architettura | Stato |
|---|---|---|
| Windows 10 / 11 | x86_64 | ✅ Supportato |
| macOS 13+ | Apple Silicon (M1/M2/M3) | ✅ Supportato |
| macOS 13+ | Intel (x86_64) | ✅ Supportato |
| Linux (Ubuntu/Arch/Debian) | x86_64 | ✅ Supportato |
| Linux (Fedora/CentOS) | ARM64 | ✅ Supportato |
---
## 📦 Spazio su Disco Necessario
| Componente | Dimensione |
|---|---|
| Script di avvio | ~50 KB |
| Runtime (Python + Node) | ~600–900 MB per piattaforma |
| Codice sorgente Hermes | ~50 MB |
| Dati utente (conversazioni, memorie) | da ~10 MB in poi |
> Se usi la stessa cartella su più sistemi operativi, i runtime si sommano (~1,8 GB totali).
---
## 🔄 Aggiornare Hermes
Puoi aggiornare Hermes in tre modi:
**Dalla chat** — digita:
```
/hermes update
```
**Dal launcher** — vai su:
```
[4] Opzioni Avanzate → [5] Aggiorna Hermes
```
**Manuale** — cancella `.cache/runtimes/<tua-piattaforma>` e la cartella `src/hermes-agent`, poi riavvia il launcher.
---
## 🔒 Sicurezza
> ⚠️ **La tua cartella portatile contiene la tua identità digitale.**
Il file `data/.env` contiene le tue API key e `data/sessions/` contiene la cronologia completa delle tue conversazioni. Chiunque acceda alla chiavetta può accedere ai tuoi account.
**Cosa fare:**
- Cifra la chiavetta USB con **BitLocker** (Windows), **FileVault** (macOS), o **VeraCrypt** (multi-piattaforma)
- Non salvare chiavi API con saldo elevato o chiavi di produzione su drive che porti in giro
---
## 🔍 Risoluzione Problemi
**Il setup al primo avvio fallisce o va in timeout**
- Verifica la connessione internet (vengono scaricati ~600 MB)
- Se sei in una rete aziendale o scolastica, prova con una VPN
- Cancella la cartella `.cache/` e riavvia il launcher
**macOS: "impossibile aprire perché lo sviluppatore non è verificato"**
- Fai clic destro su `launch.sh` → **Apri con** → Terminal
- Oppure esegui da terminale:
```bash
xattr -dr com.apple.quarantine /percorso/hermes-portable
```
**Windows Defender blocca i file**
- È un falso positivo — gli script scaricano file da GitHub e dai server Node.js
- Clicca **"Ulteriori informazioni"** sul dialogo SmartScreen, poi **"Esegui comunque"**
- Il codice è completamente open source e leggibile nella cartella `scripts/`
**Hermes è lento dalla chiavetta USB**
- Le chiavette USB 2.0 hanno velocità di lettura/scrittura lenta
- Usa una chiavetta **USB 3.0/3.1** o un **SSD esterno** per performance ottimali
**Gli strumenti web (Playwright/Browser) non funzionano**
- Alcune politiche di sandboxing del sistema operativo bloccano i browser da cartelle esterne
- Copia la cartella `hermes-portable` sul disco locale e riavvia da lì
---
## 📝 Credits
- **[Hermes Agent](https://github.com/NousResearch/hermes-agent)** — Core agente creato da Nous Research
- **[python-build-standalone](https://github.com/indygreg/python-build-standalone)** — Runtime Python portatile
---
*Guida basata sul repository: [techtonic2025/Hermes-USB-Portable](https://github.com/techtonic2025/Hermes-USB-Portable)*
2
0 comments
🛸 Hermes Agent — Guida all'Installazione Portatile
powered by
skool.com/enzo-di-roma-3126
Community del canale TechTonic per creare siti, UI e progetti digitali con l’AI. Workflow reali, prompt, tool e test su Antigravity.
Suggested communities
Powered by