La Guida di Athena · 14

Per l'amministratore

Utenti, motore, sentinella e pagina Sistema, programmi da installare · per chi gestisce il server

Il primo avvio

Al primo avvio il terminale del server mostra un codice di 6 cifre: serve per creare l'account amministratore. Scritto il codice, la pagina chiede anche dove può lavorare Athena: la cartella dentro cui restano i suoi strumenti (file, comandi, progetti). Ci sono dei suggerimenti (la home, Documenti, le cartelle con dentro dei progetti); se lasci vuoto è la home di chi ha avviato Athena. Dopo si cambia solo sul server: con la variabile ATHENA_WORKSPACE_ROOT, che ha sempre la precedenza, o con il file area.json nella cartella dei dati. A ogni avvio il terminale dice qual è l'area in uso.

Gli utenti

In Impostazioni → Utenti crei gli account, assegni i ruoli, reimposti le password e concedi la console (file e comandi) utente per utente. Cancellare un account cancella i suoi dati.

Il motore

In Impostazioni → Motore AI: l'indirizzo del motore (OpenAI-compatibile), il modello, la chiave API (salvata cifrata) e il certificato se è in https. /modello cambia il modello per tutti. La ricerca su internet usa un SearXNG indicato qui.

Puoi inserire un indirizzo semplice come http://server:30007 oppure completo come http://server:30007/v1: Athena aggiunge /v1 soltanto agli indirizzi senza un percorso. I percorsi espliciti del provider, per esempio https://api.openai.com/v1 o un gateway personalizzato, restano come li hai inseriti. La stessa regola vale all'avvio con ATHENA_ENGINE_URL e nelle Impostazioni.

Sistema e sentinella

La pagina Sistema mostra com'è messa la macchina del motore (GPU, memoria, servizi), letta dalla sua sentinella: indirizzo e token si inseriscono in Impostazioni → Motore AI.

Sempre in Impostazioni → Motore AI c'è il Registro delle richieste, per capire un problema insieme al team del motore: salva il testo esatto delle ultime 50 richieste di chat al motore, senza la chiave. Dentro ci sono le conversazioni e la memoria, quindi tienilo acceso solo quando serve: si spegne da solo dopo 24 ore, e spegnendolo i file si cancellano.

Nella scheda Modelli ci sono tutti i modelli configurati nel motore, divisi per lavoro: conversazione, libreria, voce, trascrizione, video. Si vede quali sono in memoria e quanto pesano. Un modello nuovo aggiunto al motore compare da solo. Con Usa questo si cambia il modello di chat per tutti: le risposte in corso finiscono, le nuove aspettano il caricamento, e nelle chat compare un avviso. Da qui si può anche fermare e riavviare il motore, e vedere chi occupa la sua memoria.

Programmi da installare

In Impostazioni → Strumenti Athena mostra il catalogo dei programmi installabili, come CadQuery, con fonte ufficiale, versione e impronte verificate. Ogni programma usa una propria cartella e non modifica le installazioni del PC.

I server MCP personali si configurano separatamente nello stesso pannello. REA, per esempio, può essere collegato come server MCP già installato e accompagnato da una skill locale. Non è incluso nel catalogo standard, non viene installato automaticamente e non richiede flag speciali o password di attivazione.

HTTPS e installazione sui dispositivi

Per installare Athena come app da Chrome su Android, il percorso documentato è Tailscale Serve. Tailscale deve essere installato sul PC del server e sui dispositivi che vi accedono, con i relativi permessi nella rete Tailscale. Ogni utente che scarica Athena può configurare la propria rete: non dipende dal dominio o dalla rete dello sviluppatore.

Con Athena avviata nella configurazione HTTPS predefinita sulla porta 8080, esegui sul PC del server:

tailscale serve --bg https+insecure://localhost:8080

Se hai già servizi configurati in Serve, controlla prima tailscale serve status per non sostituirli. Segui il collegamento proposto da Tailscale per abilitare MagicDNS e i certificati HTTPS quando richiesto. Usa Serve, che limita l’accesso alla rete Tailscale; Funnel pubblica invece il servizio su Internet.

Il comando mostra un indirizzo come https://nome-pc.nome-rete.ts.net: comunica agli utenti quello, senza aggiungere :8080. Tailscale Serve espone HTTPS sulla porta 443 e inoltra le richieste alla 8080 locale. https+insecure riguarda soltanto il collegamento al certificato autofirmato del server locale; il telefono riceve il certificato pubblico valido di Tailscale, emesso per il nome completo .ts.net. Non occorre importare certificati sui telefoni. Serve gestisce i certificati e, con --bg, riprende il servizio anche dopo il riavvio.

Verifica che Chrome indichi Connessione sicura, poi segui Installare Athena sul telefono. Gli IP Tailscale e Wi-Fi non sono coperti dal certificato .ts.net. L’app installata resta legata all’indirizzo scelto; aprendo un indirizzo diverso può essere necessario accedere di nuovo.

Documentazione ufficiale: Tailscale Serve e comando serve.

Il server

Il server di Athena riparte da solo dopo un riavvio o un errore. Il suo registro è in server.log, nella cartella dei dati di Athena.