Installazione¶

Con i prerequisiti pronti, puoi ora scaricare e avviare Ollama Easy GUI. La procedura richiede pochi minuti.

Scaricare l'applicazione¶

Scegli una cartella in cui installare l'applicazione: può essere una cartella già esistente oppure puoi crearne una nuova. Apri la cartella con Esplora risorse, in alto nella riga del percorso scrivi cmd e dai il return, si apre il Prompt dei comandi già posizionato sulla cartella di installazione.

Ora scarica l'applicazione con Git:

git clone https://github.com/paolodalprato/ollama-easy-gui.git

Git creerà una cartella chiamata ollama-easy-gui con tutti i file necessari.

Installare le dipendenze¶

Entra nella cartella appena creata:

cd ollama-easy-gui

Installa le librerie necessarie all'applicazione:

npm install

Questo comando scarica alcuni componenti aggiuntivi. L'operazione richiede circa un minuto e devi eseguirla solo la prima volta.

Avviare l'applicazione¶

Hai due modi per avviare Ollama Easy GUI: il metodo rapido e il metodo con configurazione.

Metodo rapido (npm start)¶

Il modo più semplice: apri il Prompt dei comandi nella cartella dell'applicazione e digita:

npm start

L'applicazione si avvia e mostra l'indirizzo dove raggiungerla, tipicamente http://localhost:3003. Apri questo indirizzo nel tuo browser per usare l'interfaccia.

Metodo con configurazione (file .bat)¶

Su Windows puoi usare un file batch che offre funzionalità aggiuntive: verifica degli aggiornamenti e configurazione ottimale per la tua scheda grafica.

Prima crea il file di configurazione: nella cartella dell'applicazione trovi il file start-ollama-easy-gui.bat.example. Copialo e rinominalo in start-ollama-easy-gui.bat (puoi anche dargli un altro nome, l'importante è che l'estensione sia .bat).

Poi modifica il file con un editor di testo (il Blocco Note va benissimo) per adattarlo al tuo hardware:

:: Numero di layer da eseguire sulla GPU (più alto = più veloce, ma serve più VRAM)
set "OLLAMA_GPU_LAYERS=18"

:: Abilita Flash Attention per risposte più veloci
set "OLLAMA_FLASH_ATTENTION=1"

:: Thread della CPU da usare per l'inferenza
set "OLLAMA_NUM_THREADS=24"

D'ora in poi, avvia l'applicazione facendo doppio clic sul file start-ollama-easy-gui.bat. A ogni avvio il file controlla automaticamente se ci sono aggiornamenti e li installa.

Accedere all'interfaccia¶

Qualunque metodo tu abbia usato, l'interfaccia sarà disponibile nel browser all'indirizzo:

http://localhost:3003

Se nella finestra del terminale non ci sono messaggi di errore (come nello screenshot), l'applicazione è avviata correttamente. Apri l'indirizzo nel browser per accedere all'interfaccia grafica.

Aggiornare l'applicazione¶

Se usi il file .bat, gli aggiornamenti vengono scaricati e installati automaticamente a ogni avvio.

Se invece avvii con npm start, puoi aggiornare manualmente:

1. Apri il Prompt dei comandi nella cartella dell'applicazione
2. Scarica gli aggiornamenti:

   git pull
   

3. Aggiorna le dipendenze:

   npm install