Odysseus: L'Intelligenza Artificiale Locale e Sovrana per Professionisti

Mentre il dibattito europeo sulla sovranità dei dati e sulla conformità al GDPR si fa sempre più serrato, cresce l'esigenza di soluzioni di intelligenza artificiale che non sacrifichino la privacy sull'altare dell'efficienza. In questo scenario si inserisce Odysseus, un workspace AI autogestito (self-hosted) progettato per replicare l'esperienza d'uso fluida di piattaforme proprietarie come ChatGPT e Claude, ma eseguito interamente sul proprio hardware locale, garantendo il controllo assoluto sui dati e l'assenza totale di telemetria.

L'alternativa locale e sovrana ai giganti del cloud

Nel panorama tecnologico italiano, l'adozione dell'intelligenza artificiale generativa deve scontrarsi con rigidi vincoli di riservatezza, segreto professionale e conformità normativa. Esternalizzare dati aziendali o personali verso server d'oltreoceano espone a rischi legali e di sicurezza non trascurabili. Odysseus nasce per risolvere questo paradosso: offre un'interfaccia utente moderna e reattiva, ma funziona interamente in locale (local-first).

A differenza di altre interfacce di chat locali, Odysseus non si limita a inviare prompt a un modello linguistico di grandi dimensioni (LLM - Large Language Model). Si propone come un vero e proprio ambiente di lavoro integrato che unisce chat, agenti autonomi, elaborazione di documenti, gestione della posta elettronica e agende sincronizzate.

Le funzionalità principali di Odysseus

L'ecosistema di Odysseus è composto da diversi moduli integrati, pensati per coprire le esigenze quotidiane di professionisti e sviluppatori:

• Chat Multimodello: Consente di dialogare con qualsiasi modello locale o tramite API esterne. Supporta motori di esecuzione e servizi come vLLM, llama.cpp, Ollama, OpenRouter, OpenAI e GitHub Copilot.
• Agenti Autonomi (Agent): Sfruttando la libreria di esecuzione opencode e il protocollo standard MCP (Model Context Protocol), l'agente può utilizzare strumenti esterni, accedere al web, leggere e scrivere file, eseguire comandi nella shell e memorizzare informazioni.
• Deep Research: Un modulo derivato da Tongyi DeepResearch di Alibaba, in grado di effettuare ricerche multi-step sul web, analizzare e sintetizzare diverse fonti e produrre un rapporto finale strutturato.
• Cookbook Hardware-Aware: Una sezione che esamina la configurazione del computer in uso (analizzando la memoria video disponibile o VRAM), consiglia i modelli ideali da scaricare nei formati GGUF, FP8 o AWQ e si occupa del download e della messa in funzione.
• Confronto Cieco (Compare): Uno strumento per testare due o più modelli contemporaneamente e in modo anonimo, eliminando i pregiudizi sui brand e valutando l'effettiva qualità delle risposte.
• Gestione Documenti e Note: Un editor di testo a schede con supporto per Markdown, HTML, CSV ed evidenziazione della sintassi, assistito dall'AI per modifiche e suggerimenti in tempo reale.

Integrazione avanzata con Email e Calendario

Un aspetto unico di Odysseus è la sua capacità di agire come client di produttività personale. Integra una casella di posta IMAP/SMTP in grado di effettuare un triage intelligente delle email tramite l'AI locale: riassunti automatici, bozze di risposta pronte, catalogazione dello spam e avvisi di urgenza. Dispone inoltre di un calendario locale sincronizzabile via CalDAV con servizi diffusi quali Nextcloud, Apple, Radicale o Fastmail.

Guida all'installazione rapida

Odysseus è stato strutturato per funzionare fin da subito senza configurazioni complesse. Di default, crea un account amministratore con nome utente admin (modificabile tramite la variabile ODYSSEUS_ADMIN_USER nel file di configurazione) e stampa una password temporanea direttamente nel terminale al primo avvio. Si raccomanda di modificare questa password nelle impostazioni subito dopo il primo accesso.

Installazione nativa su Linux e macOS

Se preferisci evitare la virtualizzazione di Docker o vuoi sfruttare direttamente l'accelerazione hardware Metal sui processori Apple Silicon (Mac M-series), puoi procedere con l'installazione nativa tramite Python. Assicurati di avere installato Python 3.11 o versioni successive.

bashCopia
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000

Per gli utenti macOS, gli sviluppatori hanno predisposto uno script automatizzato che installa le dipendenze Homebrew necessarie, crea l'ambiente virtuale e avvia l'applicazione sulla porta 7860 (per evitare conflitti con AirPlay, che solitamente occupa la porta 7000):

bashCopia
./start-macos.sh

Se desideri pacchettizzare l'applicazione in un'icona cliccabile all'interno della cartella Applicazioni del tuo Mac, puoi lanciare lo script di build dedicato:

bashCopia
./build-macos-app.sh

Gestione dell'hardware e accelerazione GPU

La fluidità dei modelli locali dipende fortemente dalla capacità dell'applicazione di dialogare con la scheda video. Quando si esegue Odysseus all'interno di Docker, è fondamentale configurare correttamente il passthrough della GPU affinché il modulo Cookbook possa rilevare l'hardware.

Abilitazione GPU NVIDIA

Per i sistemi dotati di schede grafiche NVIDIA, viene fornito uno script di diagnostica in grado di verificare la corretta installazione dell'NVIDIA Container Toolkit e di aggiornare il file di configurazione:

bashCopia
# Diagnostica in sola lettura (non installa nulla)
scripts/check-docker-gpu.sh

# Installazione guidata del toolkit su sistemi Ubuntu/Debian ed attivazione del profilo GPU
scripts/check-docker-gpu.sh --install-nvidia-toolkit --enable-nvidia-overlay

L'abilitazione manuale può essere effettuata aggiungendo questa istruzione all'interno del file .env:

Copia
COMPOSE_FILE=docker-compose.yml:docker/gpu.nvidia.yml

Supporto AMD ROCm

Gli utenti con schede grafiche AMD possono eseguire lo script di verifica dedicato:

bashCopia
scripts/check-docker-amd-gpu.sh

Successivamente, sarà necessario modificare manualmente il file .env inserendo il gruppo di rendering corretto rilevato dal sistema (ad esempio 989):

Copia
COMPOSE_FILE=docker-compose.yml:docker/gpu.amd.yml
RENDER_GID=989

Tabella comparativa: Odysseus vs Open WebUI vs ChatGPT

Per comprendere meglio dove si posiziona Odysseus all'interno dell'offerta attuale, abbiamo strutturato un confronto diretto basato sui requisiti operativi, l'integrazione di strumenti e il controllo dei dati:

Sicurezza e architettura per ambienti professionali

Dal momento che Odysseus integra funzionalità molto potenti (come l'accesso al terminale di sistema, l'esecuzione di script Python e la lettura di cartelle locali), gli amministratori di sistema devono considerarlo con lo stesso livello di attenzione riservato a una console di amministrazione aziendale.

Le buone norme per una messa in produzione sicura includono:

• Mantenere sempre attiva la direttiva AUTH_ENABLED=true nel file .env.
• Disabilitare la registrazione libera di nuovi utenti (open signup) all'interno del file data/auth.json subito dopo l'inizializzazione del primo account amministratore.
• Se l'applicazione viene esposta su una rete aziendale o tramite VPN (come Tailscale), forzare l'uso di certificati HTTPS sicuri. È possibile generare certificati attendibili localmente con utility come mkcert e avviare l'applicazione passando i file a Uvicorn:

  bashCopia
  python -m uvicorn app:app --host 0.0.0.0 --port 7000 --ssl-certfile=cert.pem --ssl-keyfile=key.pem

• Isolare le porte dei servizi di supporto (come la porta 8080 di SearXNG, la porta 8100 di ChromaDB o la porta 11434 di Ollama), lasciandole accessibili solo internamente a Docker ed esponendo al pubblico unicamente l'interfaccia protetta di Odysseus.