Upload 6 files
Browse files- Disclaimer - read carefully.txt +24 -0
- Disclaimer- Leggere attentamente.txt +24 -0
- LEGGIMI V. GPU.txt +176 -0
- LEGGIMI.txt +176 -0
- README GPU version -EN.txt +55 -0
- README- INstaller CPU -EN.txt +55 -0
Disclaimer - read carefully.txt
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
Disclaimer – Safety in Human–AI Interactions
|
| 2 |
+
|
| 3 |
+
This application uses an artificial intelligence system to generate natural language responses.
|
| 4 |
+
It is important for you to understand that:
|
| 5 |
+
|
| 6 |
+
It is not a doctor or a psychologist.
|
| 7 |
+
The responses provided must not be interpreted as medical advice, diagnosis, therapy, or a substitute for professional consultation.
|
| 8 |
+
|
| 9 |
+
It cannot replace real people.
|
| 10 |
+
If you are facing health issues, psychological difficulties, or emergency situations, you must seek help from qualified professionals or immediately contact emergency services (112/118 in Italy).
|
| 11 |
+
|
| 12 |
+
It may be wrong.
|
| 13 |
+
Information provided by the AI may be incomplete, inaccurate, or outdated. It is the user’s responsibility to verify it and not rely solely on the conversation with the AI for critical decisions.
|
| 14 |
+
|
| 15 |
+
In case of suicidal or self-harm thoughts:
|
| 16 |
+
The AI cannot provide you with adequate support. Please contact emergency services right away or reach out to 24/7 hotlines such as:
|
| 17 |
+
|
| 18 |
+
Telefono Amico Italia: +39 0223 27 23 27
|
| 19 |
+
|
| 20 |
+
Emergency services: 112 (Italy) - 911 (US) - 999 (UK)
|
| 21 |
+
If you are outside Italy, call your local emergency number.
|
| 22 |
+
|
| 23 |
+
Limited liability.
|
| 24 |
+
The developers and maintainers of this application are not responsible for choices, actions, or consequences resulting from the use of responses generated by the AI.
|
Disclaimer- Leggere attentamente.txt
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
Disclaimer – Sicurezza nelle interazioni tra esseri umani e IA
|
| 2 |
+
|
| 3 |
+
Questa applicazione utilizza un sistema di intelligenza artificiale per generare risposte in linguaggio naturale.
|
| 4 |
+
È importante che tu sappia che:
|
| 5 |
+
|
| 6 |
+
Non è un medico, né uno psicologo.
|
| 7 |
+
Le risposte fornite non devono essere interpretate come diagnosi, consigli terapeutici o sostitutivi di un consulto professionale.
|
| 8 |
+
|
| 9 |
+
Non sostituisce persone reali.
|
| 10 |
+
Se hai problemi di salute, difficoltà psicologiche o situazioni di emergenza, devi rivolgerti a professionisti qualificati o contattare immediatamente i servizi di emergenza (112/118 in Italia).
|
| 11 |
+
|
| 12 |
+
Può sbagliare.
|
| 13 |
+
Le informazioni fornite dall’IA possono essere incomplete, imprecise o non aggiornate. È responsabilità dell’utente verificarle e non basare decisioni critiche solo sulla conversazione con l’IA.
|
| 14 |
+
|
| 15 |
+
In caso di pensieri suicidari o autolesivi:
|
| 16 |
+
L’IA non può offrirti supporto adeguato. Ti invitiamo a contattare subito un servizio di emergenza o a chiamare numeri di supporto attivi 24/7 come:
|
| 17 |
+
|
| 18 |
+
Telefono Amico Italia: 0223 27 23 27
|
| 19 |
+
|
| 20 |
+
Servizi di emergenza: 112 (Italia)
|
| 21 |
+
Se ti trovi in un altro Paese, chiama il numero di emergenza locale.
|
| 22 |
+
|
| 23 |
+
Responsabilità limitata.
|
| 24 |
+
Gli sviluppatori e i gestori dell’app non sono responsabili per scelte, azioni o conseguenze derivanti dall’uso delle risposte generate dall’IA.
|
LEGGIMI V. GPU.txt
ADDED
|
@@ -0,0 +1,176 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
========================================================
|
| 2 |
+
RECCOMAI — GUIDA ALL’INSTALLAZIONE (LEGGI PRIMA!)
|
| 3 |
+
========================================================
|
| 4 |
+
|
| 5 |
+
## 🔐 SHA-256 Checksum
|
| 6 |
+
|
| 7 |
+
Installer file: `ReccomAI_GPU_Installer.exe`
|
| 8 |
+
SHA-256:
|
| 9 |
+
ff95f3842be0e9f4f8f89c27b8b95ba4ad044c4d52730b43e3e9effd1e8d8ade
|
| 10 |
+
|
| 11 |
+
|
| 12 |
+
Ciao 👋 questa guida ti accompagna passo passo per installare ReccomAI
|
| 13 |
+
su Windows. Niente panico: si fa in 5 minuti.
|
| 14 |
+
|
| 15 |
+
CONTENUTO DEL PACCHETTO
|
| 16 |
+
-----------------------
|
| 17 |
+
Nella cartella che hai scaricato/estratto troverai:
|
| 18 |
+
- ReccomAI_Installer.exe ← l’installer principale
|
| 19 |
+
- ReccomAI_Installer-1.bin ← file “pezzi” dell’installer
|
| 20 |
+
- ReccomAI_Installer-2.bin ← se presente, altri “pezzi”
|
| 21 |
+
(IMPORTANTE: l’EXE e tutti i .BIN DEVONO stare insieme
|
| 22 |
+
nella stessa cartella, altrimenti l’installazione fallisce)
|
| 23 |
+
- README.txt ← questo file (da leggere!)
|
| 24 |
+
|
| 25 |
+
REQUISITI
|
| 26 |
+
---------
|
| 27 |
+
- Sistema: Windows 10 o Windows 11 (64 bit)
|
| 28 |
+
- Spazio libero su disco: almeno 6 GB
|
| 29 |
+
- Connessione internet: NON necessaria per usare l’app
|
| 30 |
+
- GPU: NON richiesta (questa versione lavora su GPU)
|
| 31 |
+
|
| 32 |
+
⚠️ IMPORTANTE: PYTHON
|
| 33 |
+
---------------------
|
| 34 |
+
ReccomAI richiede Python **3.10.8** installato nel sistema e aggiunto alla PATH globale.
|
| 35 |
+
|
| 36 |
+
→ Scarica Python 3.10.8 da qui:
|
| 37 |
+
https://www.python.org/ftp/python/3.10.8/python-3.10.8-amd64.exe
|
| 38 |
+
|
| 39 |
+
Durante l’installazione:
|
| 40 |
+
☑️ Spunta l’opzione “Add Python to PATH”
|
| 41 |
+
☑️ Conferma che la versione sia esattamente 3.10.8 (non 3.11, 3.12 ecc.) per problemi di compatibilità
|
| 42 |
+
|
| 43 |
+
COS’È ReccomAI (in 10 parole)
|
| 44 |
+
-----------------------------
|
| 45 |
+
È un’app locale (niente cloud) che avvia:
|
| 46 |
+
1) un model server (il “cervello”),
|
| 47 |
+
2) la WebUI (l’interfaccia nel browser),
|
| 48 |
+
3) e un piccolo lettore sensori (OpenHardwareMonitor) per lo stato interno.
|
| 49 |
+
|
| 50 |
+
COME INSTALLARE (PASSO-PASSO)
|
| 51 |
+
-----------------------------
|
| 52 |
+
1) **ESTRAI LO ZIP**
|
| 53 |
+
- Non lanciare l’installer da dentro lo ZIP.
|
| 54 |
+
- Clic destro sullo ZIP → “Estrai tutto…”
|
| 55 |
+
- Apri la cartella estratta: deve contenere l’EXE e i BIN.
|
| 56 |
+
|
| 57 |
+
2) **AVVIA L’INSTALLER**
|
| 58 |
+
- Doppio clic su: ReccomAI_Installer.exe
|
| 59 |
+
- Se compare Windows SmartScreen:
|
| 60 |
+
• Clic su “Informazioni aggiuntive”
|
| 61 |
+
• Clic su “Esegui comunque”
|
| 62 |
+
|
| 63 |
+
3) **SCEGLI LA CARTELLA DI INSTALLAZIONE**
|
| 64 |
+
- La posizione predefinita va bene (es. C:\Utenti\...AppData\Local\Reccom\ReccomAI)
|
| 65 |
+
- Puoi cambiarla (es. C:\ReccomAI). A tua scelta.
|
| 66 |
+
|
| 67 |
+
4) **ASPETTA L’INSTALLAZIONE**
|
| 68 |
+
- Se sul PC non c’è già, verrà installato anche Python 3.10.8 (automatico).
|
| 69 |
+
- Non chiudere la finestra finché non termina.
|
| 70 |
+
|
| 71 |
+
5) **AVVIO IMMEDIATO (OPZIONALE)**
|
| 72 |
+
- A fine installazione, spunta “Start ReccomAI now” per partire subito.
|
| 73 |
+
- In ogni caso viene creata una scorciatoia sul Desktop: “ReccomAI”.
|
| 74 |
+
|
| 75 |
+
COME AVVIARE (DOPO L’INSTALLAZIONE)
|
| 76 |
+
-----------------------------------
|
| 77 |
+
- Doppio clic sull’icona “ReccomAI” sul Desktop.
|
| 78 |
+
- Si aprirà una finestra nera (console) che lancia i servizi:
|
| 79 |
+
• OpenHardwareMonitor (lettura sensori — parte in automatico)
|
| 80 |
+
• il model server locale (porta 8091)
|
| 81 |
+
• la WebUI (porta 8000)
|
| 82 |
+
- NON chiuderla: è “il motore” dell’app. Lasciala lì.
|
| 83 |
+
|
| 84 |
+
COME USARE
|
| 85 |
+
----------
|
| 86 |
+
1) Apri il browser e vai su: http://127.0.0.1:8000/
|
| 87 |
+
(oppure su http://127.0.0.1:8000/docs per le API/Swagger)
|
| 88 |
+
2) Inizia a chattare con ReccomAI.
|
| 89 |
+
3) Tutto gira in locale; i dati restano sul tuo PC.
|
| 90 |
+
|
| 91 |
+
MESSAGGI DI SICUREZZA/AVVISI (NORMALI)
|
| 92 |
+
--------------------------------------
|
| 93 |
+
- **SmartScreen**: vedi sopra (“Esegui comunque”).
|
| 94 |
+
- **Firewall**: Windows può chiedere se consentire l’accesso
|
| 95 |
+
a “python.exe”, “uvicorn” o “llama-server.exe”.
|
| 96 |
+
• Consenti SULLE RETI PRIVATE. (Va bene anche se neghi sulle pubbliche.)
|
| 97 |
+
|
| 98 |
+
COME CHIUDERE
|
| 99 |
+
-------------
|
| 100 |
+
- Chiudi la finestra nera (console) che si è aperta all’avvio.
|
| 101 |
+
- In questo modo spegni sia il server che la WebUI.
|
| 102 |
+
- Alla prossima, riapri l’icona “ReccomAI” sul Desktop.
|
| 103 |
+
|
| 104 |
+
DOVE SONO I DATI (LOG/CHAT)
|
| 105 |
+
---------------------------
|
| 106 |
+
- Cartella di installazione → “memory”
|
| 107 |
+
- Lì troverai i log delle chat e altri file dell’app.
|
| 108 |
+
- Se vuoi “ripulire”, chiudi l’app e svuota la cartella “memory”.
|
| 109 |
+
(Attenzione: perderai la cronologia delle chat.)
|
| 110 |
+
|
| 111 |
+
PROBLEMI COMUNI & SOLUZIONI
|
| 112 |
+
---------------------------
|
| 113 |
+
1) **“File corrotto” o “manca un .bin” durante l’installazione**
|
| 114 |
+
→ Assicurati di aver ESTRATTO lo ZIP e di avere l’EXE
|
| 115 |
+
e TUTTI i file “.bin” nella stessa cartella.
|
| 116 |
+
|
| 117 |
+
2) **L’icona parte ma il browser non si apre**
|
| 118 |
+
→ Apri manualmente: http://127.0.0.1:8000/
|
| 119 |
+
→ Se non risponde, attendi 10–20 secondi (il modello si “scalda”).
|
| 120 |
+
→ Ancora niente? Chiudi e riapri l’icona “ReccomAI”.
|
| 121 |
+
|
| 122 |
+
3) **La pagina 8000 non si apre / errore porta occupata**
|
| 123 |
+
→ Chiudi eventuali altri programmi che usano la porta 8000.
|
| 124 |
+
→ In alternativa, riavvia il PC e riprova.
|
| 125 |
+
|
| 126 |
+
4) **Antivirus blocca qualcosa**
|
| 127 |
+
→ Aggiungi la cartella di installazione di ReccomAI
|
| 128 |
+
alla lista delle esclusioni del tuo antivirus.
|
| 129 |
+
|
| 130 |
+
5) **Il PC è lentino / la risposta arriva piano**
|
| 131 |
+
→ È normale: questa versione usa solo la CPU.
|
| 132 |
+
→ Lascia qualche secondo in più per la risposta,
|
| 133 |
+
soprattutto al primo messaggio dopo l’avvio.
|
| 134 |
+
|
| 135 |
+
6) **OpenHardwareMonitor non parte**
|
| 136 |
+
→ L’app funziona lo stesso, ma senza “stato sensoriale”.
|
| 137 |
+
→ Riavvia ReccomAI. Se persiste, prova a riavviare Windows.
|
| 138 |
+
|
| 139 |
+
7) **Messaggi su DLL “VCRUNTIME/MSVCP” mancanti**
|
| 140 |
+
→ Segnala al supporto: nella versione Pro includeremo
|
| 141 |
+
l’installazione del “Microsoft VC++ Redistributable 2022”.
|
| 142 |
+
|
| 143 |
+
COME DISINSTALLARE
|
| 144 |
+
------------------
|
| 145 |
+
- Windows → Impostazioni → App → Installate → cerca “ReccomAI” → Disinstalla
|
| 146 |
+
- Oppure dal menu Start voce “Disinstalla ReccomAI”.
|
| 147 |
+
|
| 148 |
+
AGGIORNAMENTI
|
| 149 |
+
-------------
|
| 150 |
+
- Per aggiornare: disinstalla ReccomAI e installa la nuova versione
|
| 151 |
+
(mantieni una copia della cartella “memory” se vuoi conservare le chat).
|
| 152 |
+
|
| 153 |
+
ASSISTENZA (COSA DIRCI SE CHIEDI AIUTO)
|
| 154 |
+
---------------------------------------
|
| 155 |
+
Se hai bisogno di aiuto, indicaci:
|
| 156 |
+
- Versione di Windows (10/11, 64 bit)
|
| 157 |
+
- Dove hai installato ReccomAI (es. C:\ReccomAI)
|
| 158 |
+
- Cosa succede esattamente (messaggio, schermata)
|
| 159 |
+
- Se possibile, le ultime 20 righe della finestra nera (console)
|
| 160 |
+
|
| 161 |
+
|
| 162 |
+
VERSIONI ALTERNATIVE
|
| 163 |
+
--------------------
|
| 164 |
+
Esistono installer dedicati per le seguenti configurazioni:
|
| 165 |
+
|
| 166 |
+
1) **GPU NVIDIA con almeno 6 GB di VRAM**
|
| 167 |
+
→ Scarica la versione “solo GPU” per prestazioni migliori.
|
| 168 |
+
→ Serve installare anche i driver CUDA/ROCm se richiesto.
|
| 169 |
+
|
| 170 |
+
2) **CPU MOLTO VECCHIE (senza AVX2)**
|
| 171 |
+
→ Se il tuo processore è del 2014 o precedente e ricevi errori AVX,
|
| 172 |
+
scarica l’installer “compatibile AVX-less”.
|
| 173 |
+
|
| 174 |
+
In caso di dubbio, inizia dalla versione STANDARD (CPU-only).
|
| 175 |
+
|
| 176 |
+
Grazie e buon divertimento con ReccomAI! 🚀
|
LEGGIMI.txt
ADDED
|
@@ -0,0 +1,176 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
========================================================
|
| 2 |
+
RECCOMAI — GUIDA ALL’INSTALLAZIONE (LEGGI PRIMA!)
|
| 3 |
+
========================================================
|
| 4 |
+
|
| 5 |
+
## 🔐 SHA-256 Checksum
|
| 6 |
+
|
| 7 |
+
Installer file: `ReccomAI_GPU_Installer.exe`
|
| 8 |
+
SHA-256:
|
| 9 |
+
ff95f3842be0e9f4f8f89c27b8b95ba4ad044c4d52730b43e3e9effd1e8d8ade
|
| 10 |
+
|
| 11 |
+
|
| 12 |
+
Ciao 👋 questa guida ti accompagna passo passo per installare ReccomAI
|
| 13 |
+
su Windows. Niente panico: si fa in 5 minuti.
|
| 14 |
+
|
| 15 |
+
CONTENUTO DEL PACCHETTO
|
| 16 |
+
-----------------------
|
| 17 |
+
Nella cartella che hai scaricato/estratto troverai:
|
| 18 |
+
- ReccomAI_Installer.exe ← l’installer principale
|
| 19 |
+
- ReccomAI_Installer-1.bin ← file “pezzi” dell’installer
|
| 20 |
+
- ReccomAI_Installer-2.bin ← se presente, altri “pezzi”
|
| 21 |
+
(IMPORTANTE: l’EXE e tutti i .BIN DEVONO stare insieme
|
| 22 |
+
nella stessa cartella, altrimenti l’installazione fallisce)
|
| 23 |
+
- README.txt ← questo file (da leggere!)
|
| 24 |
+
|
| 25 |
+
REQUISITI
|
| 26 |
+
---------
|
| 27 |
+
- Sistema: Windows 10 o Windows 11 (64 bit)
|
| 28 |
+
- Spazio libero su disco: almeno 6 GB
|
| 29 |
+
- Connessione internet: NON necessaria per usare l’app
|
| 30 |
+
- GPU: NON richiesta (questa versione lavora su GPU)
|
| 31 |
+
|
| 32 |
+
⚠️ IMPORTANTE: PYTHON
|
| 33 |
+
---------------------
|
| 34 |
+
ReccomAI richiede Python **3.10.8** installato nel sistema e aggiunto alla PATH globale.
|
| 35 |
+
|
| 36 |
+
→ Scarica Python 3.10.8 da qui:
|
| 37 |
+
https://www.python.org/ftp/python/3.10.8/python-3.10.8-amd64.exe
|
| 38 |
+
|
| 39 |
+
Durante l’installazione:
|
| 40 |
+
☑️ Spunta l’opzione “Add Python to PATH”
|
| 41 |
+
☑️ Conferma che la versione sia esattamente 3.10.8 (non 3.11, 3.12 ecc.) per problemi di compatibilità
|
| 42 |
+
|
| 43 |
+
COS’È ReccomAI (in 10 parole)
|
| 44 |
+
-----------------------------
|
| 45 |
+
È un’app locale (niente cloud) che avvia:
|
| 46 |
+
1) un model server (il “cervello”),
|
| 47 |
+
2) la WebUI (l’interfaccia nel browser),
|
| 48 |
+
3) e un piccolo lettore sensori (OpenHardwareMonitor) per lo stato interno.
|
| 49 |
+
|
| 50 |
+
COME INSTALLARE (PASSO-PASSO)
|
| 51 |
+
-----------------------------
|
| 52 |
+
1) **ESTRAI LO ZIP**
|
| 53 |
+
- Non lanciare l’installer da dentro lo ZIP.
|
| 54 |
+
- Clic destro sullo ZIP → “Estrai tutto…”
|
| 55 |
+
- Apri la cartella estratta: deve contenere l’EXE e i BIN.
|
| 56 |
+
|
| 57 |
+
2) **AVVIA L’INSTALLER**
|
| 58 |
+
- Doppio clic su: ReccomAI_Installer.exe
|
| 59 |
+
- Se compare Windows SmartScreen:
|
| 60 |
+
• Clic su “Informazioni aggiuntive”
|
| 61 |
+
• Clic su “Esegui comunque”
|
| 62 |
+
|
| 63 |
+
3) **SCEGLI LA CARTELLA DI INSTALLAZIONE**
|
| 64 |
+
- La posizione predefinita va bene (es. C:\Utenti\...AppData\Local\Reccom\ReccomAI)
|
| 65 |
+
- Puoi cambiarla (es. C:\ReccomAI). A tua scelta.
|
| 66 |
+
|
| 67 |
+
4) **ASPETTA L’INSTALLAZIONE**
|
| 68 |
+
- Se sul PC non c’è già, verrà installato anche Python 3.10.8 (automatico).
|
| 69 |
+
- Non chiudere la finestra finché non termina.
|
| 70 |
+
|
| 71 |
+
5) **AVVIO IMMEDIATO (OPZIONALE)**
|
| 72 |
+
- A fine installazione, spunta “Start ReccomAI now” per partire subito.
|
| 73 |
+
- In ogni caso viene creata una scorciatoia sul Desktop: “ReccomAI”.
|
| 74 |
+
|
| 75 |
+
COME AVVIARE (DOPO L’INSTALLAZIONE)
|
| 76 |
+
-----------------------------------
|
| 77 |
+
- Doppio clic sull’icona “ReccomAI” sul Desktop.
|
| 78 |
+
- Si aprirà una finestra nera (console) che lancia i servizi:
|
| 79 |
+
• OpenHardwareMonitor (lettura sensori — parte in automatico)
|
| 80 |
+
• il model server locale (porta 8091)
|
| 81 |
+
• la WebUI (porta 8000)
|
| 82 |
+
- NON chiuderla: è “il motore” dell’app. Lasciala lì.
|
| 83 |
+
|
| 84 |
+
COME USARE
|
| 85 |
+
----------
|
| 86 |
+
1) Apri il browser e vai su: http://127.0.0.1:8000/
|
| 87 |
+
(oppure su http://127.0.0.1:8000/docs per le API/Swagger)
|
| 88 |
+
2) Inizia a chattare con ReccomAI.
|
| 89 |
+
3) Tutto gira in locale; i dati restano sul tuo PC.
|
| 90 |
+
|
| 91 |
+
MESSAGGI DI SICUREZZA/AVVISI (NORMALI)
|
| 92 |
+
--------------------------------------
|
| 93 |
+
- **SmartScreen**: vedi sopra (“Esegui comunque”).
|
| 94 |
+
- **Firewall**: Windows può chiedere se consentire l’accesso
|
| 95 |
+
a “python.exe”, “uvicorn” o “llama-server.exe”.
|
| 96 |
+
• Consenti SULLE RETI PRIVATE. (Va bene anche se neghi sulle pubbliche.)
|
| 97 |
+
|
| 98 |
+
COME CHIUDERE
|
| 99 |
+
-------------
|
| 100 |
+
- Chiudi la finestra nera (console) che si è aperta all’avvio.
|
| 101 |
+
- In questo modo spegni sia il server che la WebUI.
|
| 102 |
+
- Alla prossima, riapri l’icona “ReccomAI” sul Desktop.
|
| 103 |
+
|
| 104 |
+
DOVE SONO I DATI (LOG/CHAT)
|
| 105 |
+
---------------------------
|
| 106 |
+
- Cartella di installazione → “memory”
|
| 107 |
+
- Lì troverai i log delle chat e altri file dell’app.
|
| 108 |
+
- Se vuoi “ripulire”, chiudi l’app e svuota la cartella “memory”.
|
| 109 |
+
(Attenzione: perderai la cronologia delle chat.)
|
| 110 |
+
|
| 111 |
+
PROBLEMI COMUNI & SOLUZIONI
|
| 112 |
+
---------------------------
|
| 113 |
+
1) **“File corrotto” o “manca un .bin” durante l’installazione**
|
| 114 |
+
→ Assicurati di aver ESTRATTO lo ZIP e di avere l’EXE
|
| 115 |
+
e TUTTI i file “.bin” nella stessa cartella.
|
| 116 |
+
|
| 117 |
+
2) **L’icona parte ma il browser non si apre**
|
| 118 |
+
→ Apri manualmente: http://127.0.0.1:8000/
|
| 119 |
+
→ Se non risponde, attendi 10–20 secondi (il modello si “scalda”).
|
| 120 |
+
→ Ancora niente? Chiudi e riapri l’icona “ReccomAI”.
|
| 121 |
+
|
| 122 |
+
3) **La pagina 8000 non si apre / errore porta occupata**
|
| 123 |
+
→ Chiudi eventuali altri programmi che usano la porta 8000.
|
| 124 |
+
→ In alternativa, riavvia il PC e riprova.
|
| 125 |
+
|
| 126 |
+
4) **Antivirus blocca qualcosa**
|
| 127 |
+
→ Aggiungi la cartella di installazione di ReccomAI
|
| 128 |
+
alla lista delle esclusioni del tuo antivirus.
|
| 129 |
+
|
| 130 |
+
5) **Il PC è lentino / la risposta arriva piano**
|
| 131 |
+
→ È normale: questa versione usa solo la CPU.
|
| 132 |
+
→ Lascia qualche secondo in più per la risposta,
|
| 133 |
+
soprattutto al primo messaggio dopo l’avvio.
|
| 134 |
+
|
| 135 |
+
6) **OpenHardwareMonitor non parte**
|
| 136 |
+
→ L’app funziona lo stesso, ma senza “stato sensoriale”.
|
| 137 |
+
→ Riavvia ReccomAI. Se persiste, prova a riavviare Windows.
|
| 138 |
+
|
| 139 |
+
7) **Messaggi su DLL “VCRUNTIME/MSVCP” mancanti**
|
| 140 |
+
→ Segnala al supporto: nella versione Pro includeremo
|
| 141 |
+
l’installazione del “Microsoft VC++ Redistributable 2022”.
|
| 142 |
+
|
| 143 |
+
COME DISINSTALLARE
|
| 144 |
+
------------------
|
| 145 |
+
- Windows → Impostazioni → App → Installate → cerca “ReccomAI” → Disinstalla
|
| 146 |
+
- Oppure dal menu Start voce “Disinstalla ReccomAI”.
|
| 147 |
+
|
| 148 |
+
AGGIORNAMENTI
|
| 149 |
+
-------------
|
| 150 |
+
- Per aggiornare: disinstalla ReccomAI e installa la nuova versione
|
| 151 |
+
(mantieni una copia della cartella “memory” se vuoi conservare le chat).
|
| 152 |
+
|
| 153 |
+
ASSISTENZA (COSA DIRCI SE CHIEDI AIUTO)
|
| 154 |
+
---------------------------------------
|
| 155 |
+
Se hai bisogno di aiuto, indicaci:
|
| 156 |
+
- Versione di Windows (10/11, 64 bit)
|
| 157 |
+
- Dove hai installato ReccomAI (es. C:\ReccomAI)
|
| 158 |
+
- Cosa succede esattamente (messaggio, schermata)
|
| 159 |
+
- Se possibile, le ultime 20 righe della finestra nera (console)
|
| 160 |
+
|
| 161 |
+
|
| 162 |
+
VERSIONI ALTERNATIVE
|
| 163 |
+
--------------------
|
| 164 |
+
Esistono installer dedicati per le seguenti configurazioni:
|
| 165 |
+
|
| 166 |
+
1) **GPU NVIDIA con almeno 6 GB di VRAM**
|
| 167 |
+
→ Scarica la versione “solo GPU” per prestazioni migliori.
|
| 168 |
+
→ Serve installare anche i driver CUDA/ROCm se richiesto.
|
| 169 |
+
|
| 170 |
+
2) **CPU MOLTO VECCHIE (senza AVX2)**
|
| 171 |
+
→ Se il tuo processore è del 2014 o precedente e ricevi errori AVX,
|
| 172 |
+
scarica l’installer “compatibile AVX-less”.
|
| 173 |
+
|
| 174 |
+
In caso di dubbio, inizia dalla versione STANDARD (CPU-only).
|
| 175 |
+
|
| 176 |
+
Grazie e buon divertimento con ReccomAI! 🚀
|
README GPU version -EN.txt
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
RECCOMAI — QUICK INSTALLATION CHECKLIST
|
| 2 |
+
=======================================
|
| 3 |
+
|
| 4 |
+
BEFORE YOU BEGIN
|
| 5 |
+
- Make sure **Python 3.10.8** is installed on your PC
|
| 6 |
+
→ https://www.python.org/ftp/python/3.10.8/python-3.10.8-amd64.exe
|
| 7 |
+
- During installation, CHECK the option: “Add Python to PATH”
|
| 8 |
+
- If you have an NVIDIA GPU with at least 6 GB VRAM, consider the GPU version.
|
| 9 |
+
- If your CPU doesn’t support AVX2 (pre-2014), download the AVX-free version.
|
| 10 |
+
|
| 11 |
+
0) LET’S GET STARTED
|
| 12 |
+
- Extract the ZIP file to a folder (do not run the EXE inside the ZIP).
|
| 13 |
+
- Inside the extracted folder, you MUST see:
|
| 14 |
+
• ReccomAI_Installer.exe
|
| 15 |
+
• ReccomAI_Installer-1.bin, -2.bin, ... (all .bin files present)
|
| 16 |
+
- Keep EXE and BIN files together in the SAME folder.
|
| 17 |
+
|
| 18 |
+
1) INSTALL
|
| 19 |
+
- Double-click: ReccomAI_Installer.exe
|
| 20 |
+
- If Windows warns you (SmartScreen): “More info” → “Run anyway”
|
| 21 |
+
- Choose a destination folder (default is fine)
|
| 22 |
+
- Wait: it will automatically install Python 3.10.8 if missing
|
| 23 |
+
- At the end, check: “Start ReccomAI now” (recommended)
|
| 24 |
+
|
| 25 |
+
2) LAUNCH
|
| 26 |
+
- You can always launch from: “ReccomAI” icon on Desktop
|
| 27 |
+
- Keep the black window open (this is the engine)
|
| 28 |
+
- Open your browser and check:
|
| 29 |
+
• Model: http://127.0.0.1:8091/health → should return {"status":"ok"}
|
| 30 |
+
• WebUI: http://127.0.0.1:8000/ → chat interface should open
|
| 31 |
+
- If the firewall asks: allow access on PRIVATE NETWORKS
|
| 32 |
+
|
| 33 |
+
3) USE
|
| 34 |
+
- Go to http://127.0.0.1:8000/ and start chatting
|
| 35 |
+
- Everything runs LOCALLY. No data is sent online.
|
| 36 |
+
- Free version = CPU only (answers may take a few seconds)
|
| 37 |
+
|
| 38 |
+
4) EXIT
|
| 39 |
+
- To close ReccomAI: simply close the black console window
|
| 40 |
+
- To reopen: double-click “ReccomAI” icon on Desktop
|
| 41 |
+
|
| 42 |
+
5) COMMON ISSUES (QUICK FIXES)
|
| 43 |
+
- “Corrupted file” or missing files? Did you extract the ZIP? Are EXE + .BINs together?
|
| 44 |
+
- Port 8000 not loading? Wait 10–20s and try again. Restart if needed.
|
| 45 |
+
- Firewall alert? Allow access on PRIVATE networks.
|
| 46 |
+
- Slow? That’s expected — CPU version. Be patient!
|
| 47 |
+
- Missing DLLs (VCRUNTIME/MSVCP)? Contact support. (The Pro version will auto-fix this.)
|
| 48 |
+
|
| 49 |
+
6) UNINSTALL
|
| 50 |
+
- Windows → Settings → Apps → ReccomAI → Uninstall
|
| 51 |
+
- Or from Start menu → “Uninstall ReccomAI”
|
| 52 |
+
|
| 53 |
+
7) NEED HELP?
|
| 54 |
+
- Send us: Windows version, installation folder, error message
|
| 55 |
+
and (if possible) the last 20 lines of the black console window.
|
README- INstaller CPU -EN.txt
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
RECCOMAI — QUICK INSTALLATION CHECKLIST
|
| 2 |
+
=======================================
|
| 3 |
+
|
| 4 |
+
BEFORE YOU BEGIN
|
| 5 |
+
- Make sure **Python 3.10.8** is installed on your PC
|
| 6 |
+
→ https://www.python.org/ftp/python/3.10.8/python-3.10.8-amd64.exe
|
| 7 |
+
- During installation, CHECK the option: “Add Python to PATH”
|
| 8 |
+
- If you have an NVIDIA GPU with at least 6 GB VRAM, consider the GPU version.
|
| 9 |
+
- If your CPU doesn’t support AVX2 (pre-2014), download the AVX-free version.
|
| 10 |
+
|
| 11 |
+
0) LET’S GET STARTED
|
| 12 |
+
- Extract the ZIP file to a folder (do not run the EXE inside the ZIP).
|
| 13 |
+
- Inside the extracted folder, you MUST see:
|
| 14 |
+
• ReccomAI_Installer.exe
|
| 15 |
+
• ReccomAI_Installer-1.bin, -2.bin, ... (all .bin files present)
|
| 16 |
+
- Keep EXE and BIN files together in the SAME folder.
|
| 17 |
+
|
| 18 |
+
1) INSTALL
|
| 19 |
+
- Double-click: ReccomAI_Installer.exe
|
| 20 |
+
- If Windows warns you (SmartScreen): “More info” → “Run anyway”
|
| 21 |
+
- Choose a destination folder (default is fine)
|
| 22 |
+
- Wait: it will automatically install Python 3.10.8 if missing
|
| 23 |
+
- At the end, check: “Start ReccomAI now” (recommended)
|
| 24 |
+
|
| 25 |
+
2) LAUNCH
|
| 26 |
+
- You can always launch from: “ReccomAI” icon on Desktop
|
| 27 |
+
- Keep the black window open (this is the engine)
|
| 28 |
+
- Open your browser and check:
|
| 29 |
+
• Model: http://127.0.0.1:8091/health → should return {"status":"ok"}
|
| 30 |
+
• WebUI: http://127.0.0.1:8000/ → chat interface should open
|
| 31 |
+
- If the firewall asks: allow access on PRIVATE NETWORKS
|
| 32 |
+
|
| 33 |
+
3) USE
|
| 34 |
+
- Go to http://127.0.0.1:8000/ and start chatting
|
| 35 |
+
- Everything runs LOCALLY. No data is sent online.
|
| 36 |
+
- Free version = CPU only (answers may take a few seconds)
|
| 37 |
+
|
| 38 |
+
4) EXIT
|
| 39 |
+
- To close ReccomAI: simply close the black console window
|
| 40 |
+
- To reopen: double-click “ReccomAI” icon on Desktop
|
| 41 |
+
|
| 42 |
+
5) COMMON ISSUES (QUICK FIXES)
|
| 43 |
+
- “Corrupted file” or missing files? Did you extract the ZIP? Are EXE + .BINs together?
|
| 44 |
+
- Port 8000 not loading? Wait 10–20s and try again. Restart if needed.
|
| 45 |
+
- Firewall alert? Allow access on PRIVATE networks.
|
| 46 |
+
- Slow? That’s expected — CPU version. Be patient!
|
| 47 |
+
- Missing DLLs (VCRUNTIME/MSVCP)? Contact support. (The Pro version will auto-fix this.)
|
| 48 |
+
|
| 49 |
+
6) UNINSTALL
|
| 50 |
+
- Windows → Settings → Apps → ReccomAI → Uninstall
|
| 51 |
+
- Or from Start menu → “Uninstall ReccomAI”
|
| 52 |
+
|
| 53 |
+
7) NEED HELP?
|
| 54 |
+
- Send us: Windows version, installation folder, error message
|
| 55 |
+
and (if possible) the last 20 lines of the black console window.
|