ROS - LEGGIMI
============

ROS apre nel browser una pagina da cui parli con l'intelligenza artificiale:
con i modelli a pagamento (OpenAI, Anthropic, Google, DeepSeek, Mistral...)
usando le tue chiavi API, oppure con modelli che girano gratis sul tuo PC
(Ollama). Puoi fargli leggere i tuoi documenti (PDF, Word, testo) e, se vuoi,
farlo usare ad altre persone con un codice.

Tutto resta in questa cartella, sul tuo computer. ROS non manda niente a chi
l'ha scritto.


COSA SERVE
- Windows 10 o 11 a 64 bit
- almeno 1 GB libero dove metti la cartella (4 GB di memoria se vuoi i modelli
  locali)
- internet la prima volta, per l'installazione


COME SI COMINCIA
1. Estrai questa cartella dove vuoi (anche su una chiavetta).
2. Doppio clic su INSTALLA.bat. Ti fa leggere e accettare la licenza, prepara
   tutto e ti chiede se vuoi le parti facoltative. Si puo' rilanciare quando
   vuoi: quello che c'e' gia' lo salta.
3. Doppio clic su ROS.bat (o sull'icona «ROS» del Desktop). Si apre la finestra
   di ROS: li' metti le tue chiavi API, scegli i modelli e crei il tuo codice.
4. Apri il browser su http://127.0.0.1:8789 ed entra col tuo codice.


IL PRIMO ALIAS (UN ESPERTO CHE RISPONDE DAI TUOI DOCUMENTI)
Un alias e' un "personaggio" con le sue istruzioni e i suoi archivi: per
esempio un «Esperto di Dante» che risponde leggendo la Divina Commedia e i
tuoi appunti di letteratura. Si prepara nella finestra di ROS, in quest'ordine:

1. «Modelli permessi»: aggiungi almeno un modello, selezionalo, clicca «Rendi
   predefinito» e poi «Salva e pubblica». Un modello solo in tabella non conta:
   finche' non e' pubblicato, «Profili e codici» e la pagina non lo vedono.
2. «Funzioni»: accendi «Tendina degli alias» (nasce spenta) e «Archivi», poi
   «Salva e pubblica». Una funzione non accesa e pubblicata non compare nella
   pagina: senza questo passo la tendina degli alias non c'e'.
3. «Archivi»: «Crea archivio» (codice vuoto = lo vedono tutti; con un codice =
   solo quel profilo), «Aggiungi documenti…» (PDF, Word, .txt, .md; i PDF
   scansionati senza testo vengono rifiutati), poi «Indicizza». Con «Prova una
   domanda» vedi quali brani trova, senza spendere niente.
   Se Ollama e' acceso con il modello di embedding (scheda «Eco»), la ricerca
   capisce il senso delle domande; senza, cerca le parole della domanda, e le
   risposte sono meno precise. Vale la pena indicizzare con Ollama acceso.
4. «Prompt e alias»: «Nuovo», scrivi id (solo minuscole, numeri, _ e -) e nome;
   nella descrizione metti le istruzioni del personaggio, per esempio «Sei un
   esperto di Dante: rispondi solo in base ai documenti, citando canto e
   versi; se la risposta non c'e', dillo». Lasciata vuota, l'alias risponde
   come il modello senza istruzioni. Le istruzioni restano nella finestra: chi
   usa la pagina vede solo il nome dell'alias. Spunta l'archivio giusto, poi
   «Salva alias» e «Salva e pubblica».
   Nella scheda «Eco», «Chi risponde» deve essere «contesto» (e' il
   predefinito): e' l'unica modalita' in cui l'alias legge le sue istruzioni.
   Con «deterministico» nessun modello risponde, e arrivano i brani trovati
   cosi' come sono.
5. Nel browser ricarica la pagina (F5): sopra la domanda compare la tendina
   degli alias. Scegli il tuo e chiedi.


DAL TELEFONO (FACOLTATIVO)
INSTALLA, al passo 9, ti propone Tailscale: una rete privata fra i tuoi
dispositivi. Con Tailscale anche sul telefono (stesso account), ROS.bat ti
scrive l'indirizzo da aprire. ROS non diventa pubblico su internet.


AGGIORNARE
Ogni versione di ROS dura un anno: dopo sei mesi ti avvisa, dopo dodici non
parte piu' finche' non installi quella nuova. Per aggiornare scarica la
versione nuova ed estraila NELLA STESSA CARTELLA di quella vecchia: i tuoi dati
(cartella sistema\casa), le tue chiavi e il Python gia' installato restano.


I TUOI DATI E LE TUE CHIAVI
Stanno in sistema\casa e in sistema\.env. Chi ha la cartella ha anche quelli:
se la tieni su una chiavetta, trattala come un portafoglio.


LICENZA
ROS e' gratuito, e si usa alle condizioni del file LICENZA.txt.
