Documentazione
Deployment
Atheneo Pro è un prodotto client-server che gira interamente in rete locale, sull’hardware del bundle installato presso lo studio. Nessuna componente è ospitata in cloud.
Architettura in breve
- Server applicativo: FastAPI servito da uvicorn.
- LLM locale: Ollama, eseguito sulla stessa macchina del bundle, senza chiamate esterne.
- Storage: database locale su file (SQLite) con vector store integrato per la ricerca semantica.
- Accesso: i client (browser, integrazioni) si collegano al server sulla LAN dello studio, opzionalmente via VPN per l’accesso remoto.
Bundle hardware
L’hardware viene dimensionato in base al numero di utenti e al volume di documenti dello studio. Un controllo automatico in fase di installazione verifica RAM, CPU e spazio disco prima di procedere.
Passi tipici di installazione
- Predisposizione dell’hardware del bundle e della rete locale.
- Installazione del runtime LLM locale e download del modello previsto.
- Avvio del server applicativo come servizio gestito dal sistema operativo.
- Configurazione iniziale: account owner, organizzazione, parametri di rete.
- HTTPS in LAN e, se richiesto, accesso remoto via VPN.
- Verifica di salute del servizio e primo accesso dall’interfaccia web.
Aggiornamenti firmati
Gli aggiornamenti del software sono distribuiti tramite un canale
firmato con GPG: l’installazione scarica e
verifica la firma prima di applicare qualsiasi modifica. La chiave
pubblica per la verifica è pubblicata su questo sito in
/.well-known/atheneo-signing.pub.asc.
La documentazione completa di deployment viene fornita allo studio in fase di setup, con i comandi esatti e i parametri calibrati sull’hardware consegnato.