TuaGPT

Introduzione

TuaGPT è un client desktop per modelli di linguaggio (LLM) che si connette a server compatibili con l'API OpenAI (Ollama, TuaGate, LM Studio, ecc.). Offre funzionalità avanzate come RAG (Retrieval-Augmented Generation), ricerca web, supporto multimodale e molto altro.

Requisiti

• Windows 10/11
• .NET 8.0
• Un server LLM (Ollama, LM Studio, ecc.)

Server e API supportate

TuaGPT è compatibile con:

• TuaGate – Gateway per accesso a LM Studio, Ollama, OpenAI, Anthropic, ecc.
• LM Studio – Modelli locali con API OpenAI-compatible
• Ollama – Modelli locali e vision (LLaVA, Llama, ecc.)
• OpenAI API – GPT-4, GPT-3.5 e altri

Interfaccia principale

L'interfaccia è organizzata in diverse aree:

Barra strumenti superiore

• Aggiorna Modelli – Ricarica l'elenco dei modelli disponibili dal server
• Selettore modelli – Scegli il modello LLM da utilizzare
• Test LLM – Verifica che il modello selezionato risponda correttamente
• RAG Avanzato – Apre il sistema di gestione documenti RAG
• Gestione Prompt – Gestisci template di prompt riutilizzabili
• Condivisione – Gestione condivisione documenti e conversazioni
• Esporta Chat – Esporta conversazioni in vari formati
• Planner – Calendario e task interni (database locale); vedi sezione Planner
• Dashboard ONNX – Gestione modelli ONNX (embedding, traduzione, ecc.)
• Impostazioni – Configurazione server, parametri LLM, tema, ecc.
• Info – Informazioni su licenza e versione

Barra di stato inferiore

Mostra in tempo reale: modello caricato, stato connessione server, OCR, RAG, file contestuali, ricerca web. Il pulsante Interrompi appare durante operazioni lunghe per annullarle.

Layout generale

Sotto la barra strumenti e sopra la barra di stato, la finestra principale è organizzata in tre colonne:

• Sinistra — Gestione Conversazioni: filtro per gruppo e per data, pulsante Ordina chat, elenco delle conversazioni (righe ampie con titolo e segnalazioni visive: ad es. segmento sotto il titolo se è in corso un compito agente FN su quella chat), Gestione Archivio e Cancella tutte. Il menu contestuale sulla lista offre titolo, note, archiviazione, gruppi, etichette, arresto agente e pannello agenti.
• Centro — Conversazione: in alto, Inserisci Prompt, Crea nuova conversazione (menu: normale o effimera), caselle Abilita ricerca web / Ricerca profonda, accesso rapido alla cartella sicura; al centro l’area messaggi (ChatDisplayBox); in basso eventuale striscia di anteprima immagini, il campo di composizione, Invia, Cerca (ricerca unificata con inserimento risultati in chat; tasto destro per le opzioni), Query Tune, Immagine, Apri Editor e Svuota.
• Destra — colonna contesto e strumenti: in alto il riquadro Gestione Contesto Conversazione (elenco file contestuali con drag-and-drop, Abilita Archivio RAG per la chat corrente, Filtra dati RAG, caricamento e cancellazione file); al centro il gruppo Tasti FN con pulsanti di scorrimento e i tasti collegati ai prompt; in basso l’area di riepilogo della conversazione selezionata (menu contestuale: consumi token, dati chat, copia, Arresta agente se in corso un compito FN in background, Apri pannello agenti… per la dashboard). Nella barra strumenti può comparire l’indicatore di animazione inferenza durante le elaborazioni.

La traduzione documenti (modelli ONNX) non è un pannello fisso della finestra principale: si usa dalle funzioni dedicate alla traduzione, come descritto nella sezione Traduzione.

Esempi d'uso (scenari guidati)

Qui trovi percorsi tipici che puoi replicare sul tuo PC. I passi assumono che il server LLM (es. Ollama) sia già in esecuzione e che in Impostazioni l'URL e il modello siano configurati correttamente.

Chat e conversazioni

Creazione conversazioni

• Conversazione normale – Salvata nel database, con QueryBoost e titolo automatico
• Conversazione effimera – Temporanea, non salvata, senza QueryBoost

Pannello conversazioni (sinistra)

• Filtra per data – Mostra chat per intervallo temporale
• Filtra per gruppo – Filtra per gruppo assegnato
• Ordina Chat – Ordine ascendente/discendente
• Gestione Archivio – Visualizza e gestisci chat archiviate
• Cancella Tutte – Elimina tutte le chat (irreversibile)

Menu contestuale sulla lista chat

• Rigenera Titolo Chat
• Modifica Titolo
• Aggiungi Note / Elimina nota
• Cancella Chat / Archivia Chat
• Assegna al gruppo / Rimuovi dal gruppo
• Arresta agente — Interrompe il compito FN in background sulla conversazione selezionata (se attivo)
• Apri pannello agenti… — Dashboard con compiti attivi in background e storico
• Gestione etichette… – Crea, modifica, elimina ed esporta etichette colore (vedi sezione Etichette chat)
• Assegna etichetta / Rimuovi etichetta – Collega la conversazione a un'etichetta per evidenziarla e classificarla nella lista

Area conversazione

• Query Tune (QueryBoost) – Migliora automaticamente la richiesta prima dell'invio
• Abilita contesto RAG – Include i documenti indicizzati nel contesto
• Abilita ricerca web – L'LLM può cercare su internet (richiede estensione browser)
• Ricerca profonda – Visita i link dei risultati ed estrae contenuto completo
• Inserisci Prompt – Usa template da Gestione Prompt
• Apri Editor – Modifica testo in un editor esterno
• Svuota – Svuota la chat corrente o interrompe lo streaming
• Immagine – Aggiungi immagini al messaggio (modelli vision)

Menu contestuale chat (label info)

• Visualizza consumi token – Query, prompt, contesto RAG, totale
• Mostra dati chat – Torna alla vista standard
• Copia Dati – Copia negli appunti

Azioni sui messaggi (ChatDisplayBox)

Se abilitato: thumbs up/down, rigenera risposta, menu con copia selezione, copia tutto, copia su Note Chat.

Formattazione messaggi

La chat supporta Markdown completo, tabelle, grafici ASCII, LaTeX, codice con evidenziazione sintattica, link cliccabili. Configurabile tramite markdown_symbols.json.

Per note dettagliate, tasti funzione ed etichette vedi le sezioni dedicate più sotto.

Tasti funzione (FN)

I tasti FN sono pulsanti nella colonna destra associati a slot persistenti nel database. Ogni slot può lavorare in due filosofie distinte: inserimento prompt nella chat (comportamento in primo piano) oppure agente in background sulla conversazione selezionata.

Gestione degli slot (ciclo di vita “statico”)

1. Creazione slot — All’avvio l’app garantisce almeno quattro slot vuoti; altri slot compaiono quando assegni più prompt di quanti ne entrano nel riquadro visibile.
2. Collegamento al prompt — Da Gestione Prompt, Assegna FN lega il template al primo slot libero. I prompt DiSistema non sono usabili né in chat né come agente FN.
3. Ordine e visibilità — Modifica etichetta e posizione… consente di rinominare il pulsante, spostare lo slot (trackbar posizione) e configurare testo aggiuntivo, invio immediato, modalità agente, obiettivo, limiti di turni/timeout.
4. Scorrimento — Pulsanti ▲/▼ quando i tasti eccedono l’altezza del pannello.
5. Menu contestuale (tasto destro) — Spunta Invio immediato; voci per Modifica etichetta e posizione…, Assegna/Rimuovi etichetta sul pulsante (colori come le chat), Liberare lo slot, Apri pannello agenti….
6. Rimozione legame — Liberare lo slot toglie prompt e append senza cancellare il template in Gestione Prompt.

Modalità prompt (lato conversazione / “foreground”)

Predefinita quando non è attiva l’opzione agente in background nello slot.

1. Clic — Con prompt associato: variabili eventuali (dialog + salvataggio workflow per conversazione), poi inserimento nel campo messaggio con formattazione come da Inserisci Prompt.
2. Testo aggiuntivo — Se presente nello slot, viene appeso dopo il prompt nel campo composizione (stile testo utente).
3. Solo testo senza prompt — Slot senza PromptTemplateId ma con testo aggiuntivo: il clic inserisce quel testo. Opzione Solo etichetta in chat (solo se compatibile): in chat vedi un’etichetta compatta mentre il messaggio inviato all’API contiene il testo completo.
4. Invio immediato — Se attivo dal menu, dopo l’inserimento viene chiamato lo stesso flusso del pulsante Invia.

Modalità agente in background (lato compito asincrono)

Attivabile dallo stesso form di personalizzazione dello slot (Esegui come agente in background).

1. Prerequisiti — Conversazione non effimera selezionata; server LLM connesso; almeno uno tra prompt, testo aggiuntivo o Obiettivo compito.
2. Conferma utente — Il sistema mostra un riepilogo (modello usato, obiettivo, limiti) prima di accodare o avviare.
3. Modello — Si usa il modello scelto nella barra strumenti (con le stesse regole del selettore, incluso Auto TGPT).
4. Costruzione del turno — Viene generato un system prompt combinato con il compito; si allega la cronologia messaggi della chat (fino al limite configurato in API/history) e un messaggio utente sintetico che chiede di eseguire il compito in italiano.
5. Tool e RAG — Il job rispetta il contesto tool della conversazione (documenti RAG consentiti, condivisione ibrida se attiva), come un normale invio.
6. Output — La risposta viene scritta nella chat come messaggio assistente tramite streaming dedicato, senza bloccare la UI principale per altre chat.
7. Un job attivo per conversazione — Non può girare più di un agente alla volta sulla stessa chat: i clic successivi vanno in coda ed escono in ordine.
8. Turni e timeout — Parametro turni massimi (modello + tool) configurabile per slot; timeout opzionale in minuti (0 = disattivato).
9. Soft-lock — Con agente attivo, su quella conversazione sono bloccate alcune azioni (nuovo messaggio utente, RAG, file contestuali, eliminazione chat, ecc.) fino a termine o annullamento.
10. Segnalazioni — Contatore sul pulsante FN se ci sono compiti attivi per quello slot sulla chat corrente; segmento rosso sotto il titolo nella lista conversazioni; notifiche a fine compito se configurate.
11. Terminazione — Stati possibili: completato, errore, annullato dall’utente, timeout. Storico consultabile dalla Dashboard agenti.

Dashboard agenti (monitoraggio)

Apribile da menu contestuale lista chat (Apri pannello agenti…) o da menu contestuale di un tasto FN. Finestra non modale con:

• Tab Attivi — Conversazione, slot FN, orario di avvio, durata, stato, round eseguiti vs massimo, pulsanti Stop sul job in esecuzione e Annulla sulla coda.
• Tab Storico — Ultime esecuzioni con durata, token, esito ed eventuale messaggio di errore.
• Aggiornamento — Timer automatico (intervallo e on/off salvabili in configurazione) più pulsanti di refresh manuale.

Planner e calendario interno

Il planner è un agenda leggera integrata in TuaGPT: salva eventi e task nel database locale (PlannerItems), indipendente dal server LLM. Puoi usarla dall’interfaccia grafica oppure lasciare che sia il modello, tramite tool, a consultarla o modificarla in chat.

Apertura e layout (vista umana)

• Dalla barra strumenti premi Planner (icona calendario): si apre il pannello con calendari mensili e, sotto, la griglia del giorno selezionato.
• Navigazione mesi — Le frecce sui mini-calendari spostano la coppia di mesi visibile; il numero di colonne si adatta alla larghezza della finestra.
• Selezione giorno — Clic su un giorno: a destra compaiono eventi e task che intersecano quella data (ordine: attività aperte prima, poi completate/annullate).
• Segni sui giorni — I giorni con almeno un elemento planner risultano evidenziati nel calendario.
• Refresh — Pulsante per ricaricare elenchi e marcature dal database.

Ciclo di vita lato interfaccia (CRUD manuale)

1. Nuovo — Apre l’editor su un task preimpostato per il giorno selezionato; titolo obbligatorio, note, orari o flag “tutto il giorno”, stato per i task.
2. Modifica — Con una riga selezionata nella griglia giornaliera (oppure doppio clic), riapri l’editor sull’elemento esistente.
3. Elimina — Rimuove l’elemento selezionato dopo conferma.
4. Tipi — Evento (intervallo o giornata intera, può essere “occupato” o libero per il calcolo slot) e Task (stati: da fare, completato, annullato; durata stimata opzionale).
5. Doppio clic sul giorno nel calendario — Se esiste almeno un elemento quel giorno, apre direttamente il primo in modifica.

Ciclo di vita lato LLM (tool planner_*)

Se in Impostazioni → Tool LLM abiliti Tool planner (calendario e task interni) e il modello supporta le function call, l’LLM riceve funzioni dedicate. Il prompt di sistema Planner.prompt spiega al modello quando usarle (date in ISO 8601, non inventare slot).

• planner_list_items — Elenco in un intervallo UTC (filtri opzionali per tipo e stato).
• planner_create_item — Crea evento o task con campi richiesti (per gli eventi con orario servono inizio e fine).
• planner_update_item / planner_delete_item — Aggiornamento o cancellazione per ID.
• planner_busy_intervals — Geometria degli intervalli occupati (utile prima di proporre nuovi appuntamenti).
• planner_free_slots — Ricerca finestre libere data durata in minuti, buffer e fuso opzionale (IANA, es. Europe/Rome).
• planner_summarize_day — Riepilogo testuale strutturato di una giornata.

Coerenza: ogni operazione via tool scrive/legge le stesse tabelle usate dal pannello Planner: ciò che crei in chat compare nel calendario e viceversa.

Abilitazione e licenza

Il pulsante Planner in barra segue le regole di licenza dell’applicazione (come gli altri moduli avanzati). Senza tool abilitati il modello non riceve le definizioni planner_* anche se il database contiene dati.

Note chat

Le note sono un blocco di annotazioni per conversazione, separato dal flusso dei messaggi inviati al modello: servono per appunti, checklist, materiale di riferimento e file allegati collegati a quella chat.

Come si aprono e si salvano

• Dal menu contestuale sulla lista chat scegli Aggiungi Note per aprire la finestra delle note della conversazione selezionata.
• Il contenuto è salvato in formato RTF (grassetto, corsivo, dimensione carattere, ecc.). È previsto un salvataggio automatico periodico mentre la finestra è aperta; in chiusura eventuali modifiche non ancora salvate vengono confermate.
• La riga della chat in lista può segnalare visivamente la presenza di una nota con contenuto significativo.

Contenuto e allegati

• Barra di formattazione – Stili di testo, dimensione font e strumenti rapidi sulle note, come in un editor RTF.
• Collegamenti – Gli URL nel testo possono essere riconosciuti come link e aperti nel browser predefinito.
• Allegati – Puoi aggiungere file tramite pulsante dedicato o trascinamento nell’area allegati. Ogni file resta elencato nella nota per riferimento.
• Portare un allegato nel contesto della chat – Dal menu sull’allegato puoi inserire il file nel pannello File contestuali della stessa conversazione, così il modello lo usa nella richiesta successiva (se il file esiste ancora sul disco).

Integrazione con i messaggi

• Dal menu su un messaggio puoi usare Copia su Note Chat per appendere testo alle note senza riscriverlo a mano.
• Dal menu contestuale della lista chat, Elimina nota rimuove note e allegati associati a quella conversazione (operazione da usare con attenzione).

Esportazione

Nell’esportazione conversazioni puoi includere le note associate al formato scelto, così backup e documentazione restano allineati al contenuto della chat.

Etichette chat

Le etichette sono categorie visive (nome + colore) che puoi applicare a ogni conversazione per evidenziarla e classificarla nella lista a sinistra. Sono distinte dai gruppi (tag di raggruppamento già presenti in TuaGPT): gruppi e etichette possono convivere e rispondono a esigenze diverse (organizzazione per progetto vs. marcatura rapida per tipo di lavoro).

Gestione delle etichette

• Dal menu contestuale sulla chat, Gestione etichette… apre la finestra dove crei nuove etichette (nome univoco e colore), modifichi o elimini quelle esistenti. Eliminare un’etichetta la toglie da tutte le chat che la usavano.
• È disponibile l’esportazione dell’elenco etichette da quella schermata (backup o trasferimento).

Assegnazione alla conversazione

• Con una chat selezionata, nel menu contestuale usa Assegna etichetta e scegli un’etichetta tra quelle definite. A ogni conversazione può corrispondere un’etichetta alla volta.
• Rimuovi etichetta toglie solo la marcatura colore, senza cancellare la chat.
• Nella lista, le righe possono mostrare una tinta derivata dal colore dell’etichetta e, nei tooltip o nelle informazioni riepilogative, il nome dell’etichetta assegnata.

Quando usarle

Utile per segnare ad esempio «Lavoro», «Studio», «Urgente», «Da rivedere» o clienti/progetti, così a colpo d’occhio distingui le chat senza dover rileggere i titoli.

Sistema RAG (Retrieval-Augmented Generation)

Il RAG permette di indicizzare documenti e immagini per arricchire le risposte dell'LLM con contenuti pertinenti. Il flusso è: File → DocumentProcessor → Chunking → Embeddings → SQLite → Ricerca Semantica.

Formati supportati

• Documenti: txt, pdf, docx, doc, odt, ods, odp, xlsx, md, csv, html
• Immagini: png, jpg, jpeg, bmp, tiff, gif, webp (con OCR Tesseract)

Operazioni principali

• Carica file – Singoli file o cartelle intere (drag & drop supportato)
• Elabora – Estrazione testo, chunking, generazione embeddings, indicizzazione nel database vettoriale
• Reset – Rigenera chunk e embeddings con parametri attuali (utile dopo aver modificato chunk size o overlap)
• Elimina – Rimuove file e relativi dati dal database (irreversibile)
• Pausa/Riprendi – Durante elaborazione batch

Parametri configurabili

• Dimensione Chunk (100–3000) – Valori bassi = risposte più mirate; valori medi (800–1500) consigliati; valori alti = elaborazione più veloce
• Overlap (0–500) – Caratteri sovrapposti tra chunk per preservare continuità; consigliato 100–200
• Max Risultati (1–50) – Chunk inviati all'LLM come contesto; consigliato 8–15
• Soglia Similarità (0.01–1.00) – Filtro per rilevanza; consigliato 0.25–0.40

OCR per immagini

Le immagini vengono processate con OCR (Tesseract). Lingue: italiano + inglese. Soglia confidenza configurabile. Il modello di embedding è necessario per la ricerca semantica: configuralo dalla Dashboard ONNX.

Ricerca semantica

Campo di test per verificare la ricerca sui documenti indicizzati prima di usarla in chat. Il sistema combina similarità densa (embedding) e BM25 su indice testuale; con query a più parole (es. nome e cognome) i termini vengono richiesti tutti nello stesso chunk per ridurre risultati fuorvianti. Mostra chunk trovati con nome file, punteggi e anteprima testo.

PDF e tabelle: l’estrazione testo usa l’ordine spaziale dei token sul foglio (utile per graduatorie a colonne). Dopo aggiornamenti del motore di indicizzazione conviene rielaborare i documenti già caricati così chunk e indice FTS si rigenerano.

Database e archiviazione

I dati sono salvati in TuaGPT_Data.db (SQLite). Il database supporta fino a ~1.000.000 file. Ottimizzazioni automatiche: VACUUM, ANALYZE, indici.

Ricerca Web

Quando attivata, l'LLM può richiedere ricerche su internet tramite un tool (web_search). Richiede un modello che supporti i function call (Llama, Mistral, GPT, Claude, ecc.).

Configurazione

• Abilita Tool per LLM – Attiva i tool (incluso web_search)
• Estensione Browser – Usa l'estensione per ricerche reali (senza API key)
• Ricerca profonda – Visita i link dei risultati ed estrae contenuto completo (2–4 ricerche, report strutturato)
• Max link da visitare (1–10) – Numero massimo di link visitati nella ricerca profonda

Estensione browser

L'estensione comunica con TuaGPT tramite polling: TuaGPT accoda job (navigate, search, extract), l'estensione li preleva ogni 2 secondi da GET http://localhost:8765/browser/jobs, li esegue nel browser e invia i risultati con POST http://localhost:8765/browser/result. Porta default: 8765. Token di autenticazione obbligatorio (header Bearer).

Configurazione estensione: Impostazioni → Tool LLM → Estensione Browser. Usa "Copia" per il token e incollalo nel popup dell'estensione. "Test Connessione" verifica il server; "Test Navigazione" esegue un test end-to-end.

L'estensione ha priorità sul fallback DuckDuckGo/API: se non risponde, TuaGPT usa metodi alternativi.

Contenuti multimodali

TuaGPT supporta l'invio di immagini insieme al testo quando si usa un modello vision (es. LLaVA, llama3.2-vision). Le immagini vengono convertite in base64 e inviate nel formato richiesto dall'API (Ollama, LM Studio).

Modelli vision supportati

• llava – Large Language and Vision Assistant (consigliato)
• llava:13b – Versione più grande e precisa
• llava:7b – Versione più leggera
• bakllava – Alternativa a LLaVA
• llama3.2-vision – Modello vision di Llama 3.2

Formati immagine

jpg, png, gif, bmp, webp

Utilizzo

• Pulsante Immagine nell'area messaggio
• Drag & drop – Trascina immagini dall'Esplora risorse sull'area conversazione o sul pannello file contestuali
• Le immagini vengono ridimensionate automaticamente se superano 1920×1080 (per ottimizzare la trasmissione)

File contestuali

Documenti e immagini possono essere trascinati sul pannello "File Contestuali" per aggiungerli al contesto della chat corrente. Formati supportati: txt, pdf, docx, odt, xlsx, md, csv. Se non c'è conversazione attiva o è effimera, viene creata automaticamente una nuova conversazione per i documenti. Feedback visivo (evidenziazione area) durante il trascinamento. Il drop è bloccato durante lo streaming.

Gestione Prompt e template

Creazione e gestione di prompt riutilizzabili con variabili. Il Prompt Wizard guida nella definizione di template strutturati.

Prompt Wizard – campi

• Nome e descrizione – Identificativo e uso interno
• Introduzione – Parte attiva inviata al modello LLM
• Categoria – Es. Scrittura, Analisi, Codice
• Tipo attività – Classificazione del task
• Contesto e dominio – Es. Marketing, Tecnologia, Medicina
• Tono e stile – Formale, informale, tecnico, ecc.
• Formato output – Struttura desiderata della risposta
• Lunghezza – Breve, media, lunga
• Variabili – Placeholder {NOME} con validazione (testo, numero, data, scelta, email, URL, regex personalizzata)

Collegamento ai tasti funzione

Dopo aver creato o selezionato un prompt, il pulsante Assegna FN lo collega al primo slot libero dei tasti funzione. Per compiti lunghi senza occupare il campo messaggio valuta la modalità agente in background descritta nella stessa sezione.

Prompt di sistema predefiniti

Cartella SystemPrompt/ con prompt per: Analisi e ricerca (AnalistaDecisionale, AnalistaDocumenti, RicercatoreTematico), Personale e apprendimento (CoachProduttivita, PreparatoreEsami, TutorSocratico), Professionale e business (AssistenteHR, AssistenteRiunioni, ConsulenteStartup), Scrittura e contenuti (CopywriterMarketing, RevisoreTesti, TraduttoreTecnico), Specialistici (AssistenteLegale, AssistenteMedicoSanitario, ConsulenteFiscale), Sviluppo e tecnico (DocumentatoreTecnico, PairProgrammer, RevisoreCodice), oltre a RAG, WebSearch, QueryBoost, ChatSystemPrompt.

Sistema di condivisione

Condivisione on-demand di documenti RAG e conversazioni tramite TuaGate. I vettori restano nel database locale del proprietario; TuaGate memorizza solo metadata; solo i risultati delle ricerche vengono trasmessi.

Flusso operativo

1. Client A registra risorse su TuaGate (con callback_url)
2. Client B esegue query → TuaGate invia a Client A
3. Client A cerca localmente e restituisce risultati
4. TuaGate aggrega e restituisce a Client B

Interfaccia Gestione Condivisione

• Tab Documenti RAG – CheckBox per ogni documento da condividere
• Tab Conversazioni – CheckBox per ogni conversazione
• Sincronizza – Invia aggiornamenti a TuaGate
• Callback server – Porta default 8765, supporto HTTP e HTTPS

Configurazione

• Callback URL manuale – Per reti diverse o domini
• HTTPS – Certificato SSL con thumbprint
• Heartbeat – Ogni 5 minuti per mantenere registrazione attiva

Esportazione conversazioni

Seleziona una o più conversazioni (anche archiviate) e il formato. Destinazione: cartella configurabile (default: Desktop\TuaGPT_Export).

Formati disponibili:

• Testo leggibile – Formato conversazione leggibile
• Markdown – Per documentazione e GitHub
• JSON – Strutturato per backup e elaborazione programmatica
• CSV – Dati tabellari
• PDF – Documento stampabile
• Word (DOCX) – Microsoft Word
• ODT – OpenDocument Text (LibreOffice)

Opzioni: Includi timestamp, metadati (modello, data), formattazione messaggi, note associate.

Impostazioni

Per una spiegazione scheda per scheda della finestra Impostazioni (significato delle opzioni, scopo e consigli pratici) apri la pagina dedicata: Guida dettagliata alle Impostazioni.

Server e connessione

• URL server (es. http://localhost:11434 per Ollama)
• Token API (per TuaGate, OpenAI, ecc.)
• Timeout unificato (120–300 sec consigliato per modelli grandi)
• Test connessione – Verifica raggiungibilità
• Ricarica mappings – Aggiorna lista modelli dal server

Parametri LLM

• Temperature (0–2) – Basso = deterministico; medio = bilanciato; alto = creativo
• Top P (0–1) – Campionamento nucleare; consigliato 0.9
• Max Tokens (1–128000) – Limite risposta; disabilitabile per risposte illimitate
• Presence Penalty – Riduce nuovi argomenti
• Frequency Penalty – Riduce ripetizioni
• Auto-configura – Applica parametri consigliati per modello selezionato

Database e sicurezza

• Crittografia – Database cifrato con identificativo hardware; dati leggibili solo su questo PC
• Salva recupero – File cifrato con passphrase per migrare su altro computer

Interfaccia chat

• Link cliccabili – Apre URL nel browser predefinito
• Font chat e font codice – Famiglie configurabili
• Padding e line spacing
• Tema – Chiaro, Scuro, Sistema
• Icone azioni sui messaggi (thumbs up/down, refresh)
• Timestamp nei messaggi
• Messaggi di conferma operazioni
• Titolo gruppo tasti funzione – Testo opzionale per il riquadro dei tasti FN (accanto ad altre opzioni di interfaccia, se presente nella tua versione)

Tool e estensione browser

• Abilita tool per LLM
• Porta TuaGPT (default 8765)
• Token autenticazione (Rigenera, Copia, Mostra)
• Test Connessione e Test Navigazione

Log

• Salva log su file
• Log comunicazioni server e posta

Formattazione avanzata della chat

La chat supporta Markdown, tabelle, grafici ASCII, LaTeX, codice con evidenziazione sintattica. Configurazione tramite markdown_symbols.json. L’anteprima messaggi usa ChatDisplayBox (icone azioni sui messaggi, copia codice, ecc.).

Pattern Markdown supportati

• **testo** – Grassetto; *testo* – Corsivo; ~~testo~~ – Barrato
• `codice` – Codice inline; ```blocco``` – Blocco codice
• > citazione – Citazione
• # Titolo 1, ## Titolo 2, ### Titolo 3
• - elemento – Lista puntata; 1. elemento – Lista numerata
• Emoji Unicode, simboli matematici (π, ∑, ∞), frecce (→, ←)

Tabelle

Formato markdown: | Col1 | Col2 | con riga separator |---|. Renderizzate con caratteri box-drawing Unicode.

Grafici ASCII

• Barre: [BAR_CHART:Gennaio=120,Febbraio=150]
• Linee: [LINE_CHART:Q1=100,Q2=120,Q3=110]

Dashboard ONNX

Gestione modelli ONNX per funzionalità locali (nessuna connessione internet richiesta).

• Embedding – Per RAG e ricerca semantica (es. distiluse-base-multilingual-cased-v2)
• Traduzione – EN↔IT locale
• Classificazione intenti – intent-classification
• Rilevamento lingua – language-detection
• Sentiment analysis – Analisi sentiment
• NER – Named Entity Recognition

I modelli possono essere scaricati dalla dashboard. Configura il modello di embedding per il RAG.

Traduzione documenti

Pannello "Traduzione Documenti" per tradurre messaggi o documenti con modelli ONNX locali. Seleziona lingua sorgente e destinazione (EN↔IT), tipo di azione, e avvia. La traduzione avviene offline.

Gestione Archivio

Le chat archiviate non appaiono nella lista principale ma restano nel database. Apri "Gestione Archivio" per visualizzarle, ripristinarle o eliminarle definitivamente.