principedemone commited on
Commit
e12432f
·
verified ·
1 Parent(s): 007d7dc

Upload 6 files

Browse files
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.