Suggerimenti avanzati
Questa pagina raccoglie flussi di lavoro pratici che rendono Libre WebUI più veloce, ordinato e affidabile nell'uso quotidiano.
Tenere caricato un piccolo modello per l'uso quotidiano
Usa un modello locale rapido per le attività di routine e passa a modelli più grandi solo quando l'attività lo richiede.
Alcuni validi esempi per l'uso quotidiano:
gemma4:12bper chat quotidiane rapideqwen3.8:27bper attività generiche più impegnativegemma4:26bper l'efficienza MoE su hardware più potentegemma4:31bper la migliore qualità locale con architettura densenomic-embed-textper gli embedding dei documenti
Apri Modelli per vedere quali modelli sono in esecuzione. Quando la VRAM scarseggia, scarica dalla memoria quelli che non stai usando.
Usare la chat in incognito per le conversazioni da non conservare
Avvia una chat in incognito dal menu + della barra delle schede, dalla tavolozza dei comandi,
dalla pagina Home oppure dal pulsante con il fantasma nella schermata iniziale della chat. È disponibile anche
un URL diretto: /chat?incognito=1.
Una chat in incognito non viene mai conservata: sul server non viene creata alcuna sessione, non viene salvato alcun messaggio e la chat non compare mai nella barra laterale o nella cronologia. La chat mostra un banner Modalità privata ("Questa conversazione non verrà salvata"). Aprendo una chat salvata si esce dalla modalità in incognito; ricaricando una scheda in incognito si avvia una nuova chat privata vuota, quindi i turni precedenti vanno persi.
È importante comprendere il limite: la modalità in incognito controlla la persistenza, non l'esposizione al provider. Il modello selezionato, locale o remoto, riceve comunque l'intera conversazione e, se abilitato, si applica ancora il contesto dei documenti. Per una conversazione che non deve uscire dalla tua infrastruttura, abbina la modalità in incognito a un modello Ollama locale.
Gestire le schede con il menu contestuale
Fai clic con il pulsante destro su una scheda (oppure premi Shift + F10 su una scheda attiva) per:
- Chiudere la scheda
- Chiudere le altre schede
- Chiudere le schede a destra
- Chiudere tutte le schede
Home è sempre la prima scheda e non può essere chiusa. Gli amministratori dispongono anche delle
voci dirette Gestione utenti, Sistema e Utilizzo provider nel
menu + e possono fissare ciascuna delle tre nel piè di pagina della barra laterale (accanto a
Impostazioni) tramite l'icona a forma di puntina nel menu dell'avatar, così non dovranno più usare il menu.
Spostarsi rapidamente con la tavolozza dei comandi
Cmd/Ctrl + K apre la tavolozza dei comandi ovunque, anche quando il
compositore è attivo. La ricerca approssimativa comprende azioni dell'app, chat e
attività Work, quindi funzionano anche query parziali o con errori: autmtn trova
Automazioni, "pictures" trova Immagina, "dark" trova il cambio del tema.
A partire da tre caratteri cerca anche nel contenuto di messaggi, note e documenti
(incluse le note condivise con te) e mostra un estratto per ogni risultato: l'operazione
avviene in memoria sui tuoi dati decrittografati; nulla viene indicizzato in testo normale
sul disco. I caratteri corrispondenti sono evidenziati, i risultati sono ordinati per
pertinenza e, senza query, vengono mostrate le chat e le attività più recenti. Spostati con
↑/↓, apri con Enter, chiudi con Esc (oppure di nuovo Cmd/Ctrl + K).
Tema predefinito
Le nuove installazioni usano il tema scuro, applicato prima del primo rendering per evitare
un lampo chiaro. Un amministratore può cambiare il valore predefinito dell'intera istanza da
Impostazioni > Gestione utenti > Tema predefinito (Chiaro, Scuro o Nero Puro). Quel valore
predefinito colora la pagina di accesso, viene assegnato a ogni nuovo account e si applica in
qualsiasi browser che non abbia scelto un tema proprio; una preferenza personale salvata viene
sempre rispettata. Libre WebUI non segue l'impostazione del tema del sistema operativo; cambialo
esplicitamente con Cmd/Ctrl + D, con il pulsante sole/luna o dalle Impostazioni. Il pulsante
alterna Chiaro, Scuro, Nero Puro e Celeste.
Celeste segue il sole: la palette e un cielo dal vivo (sole o luna sul proprio arco, nuvole, stelle dopo il crepuscolo, una lampada che di notte segue il puntatore) cambiano minuto per minuto, con alba e tramonto che si spostano nel corso dell'anno. Selezionalo in Impostazioni > Aspetto; lì un cursore mostra l'anteprima di qualsiasi minuto della giornata e Segui l'orologio riporta all'ora reale. Senza una posizione presuppone una giornata alle medie latitudini; condividi la tua posizione (o inserisci le coordinate) e alba e tramonto vengono calcolati per il tuo cielo reale. La posizione è arrotondata a circa un chilometro, resta solo in quel browser e non viene mai inviata al server. Con una posizione puoi anche attivare Segui il meteo: le condizioni attuali arrivano direttamente da Open-Meteo al tuo browser e nuvole, pioggia, neve, nebbia e vento modellano il cielo.
Mantenere mirate le attività Work
Usa un'attività Work separata per ogni progetto o obiettivo indipendente. Ogni attività ha una propria conversazione, un'identità di container gestita e file persistenti. Il container può essere arrestato o ricreato, mentre il volume con nome sopravvive: riutilizzare la stessa attività conserva il contesto utile, mentre crearne una nuova stabilisce un confine netto.
Una buona istruzione iniziale indica al modello:
- Il risultato desiderato.
- I vincoli tecnici o di progettazione importanti.
- Il comando o il comportamento che deve verificare il completamento.
- I file o le interfacce che devono rimanere invariati.
Segui l'avanzamento in Attività, quindi esamina e verifica il risultato in File,
Git, Terminale e Anteprima. L'editor di file supporta l'evidenziazione della sintassi nei temi chiaro e scuro,
bozze non salvate gestite dal browser e la formattazione per i tipi di file supportati.
Usa Cmd/Ctrl + S per salvare e Shift + Alt + F per formattare.
Usa un modello Ollama installato che supporti gli strumenti quando vuoi che il traffico del modello rimanga nella tua infrastruttura Ollama configurata. Un modello remoto o cloud può ridurre la pressione sulla memoria di inferenza locale, ma può effettuare più chiamate a pagamento e riceve i risultati degli strumenti richiesti, che potrebbero contenere dati dell'area di lavoro.
Arrestare un'esecuzione o un'anteprima conserva l'area di lavoro. Eliminare un'attività Work rimuove definitivamente la relativa area di lavoro, quindi copia prima tutto ciò che ti serve.
Usare i personaggi per attività ripetibili
Crea personaggi per i flussi di lavoro che ripeti:
- Un revisore di codice conciso con temperatura bassa.
- Un editor di testi con una guida di stile chiara.
- Un assistente di ricerca con la ricerca nei documenti abilitata.
- Un assistente di supporto con tono e struttura delle risposte prestabiliti.
I personaggi memorizzano modello selezionato, prompt di sistema, parametri di generazione, avatar/sfondo e impostazioni facoltative di memoria/mutazione. Possono inoltre essere esportati e importati come JSON.
Conservare note durature accanto al proprio lavoro
Apri Note dal menu di creazione quando le informazioni devono rimanere indipendenti da una singola chat o attività Work. Le note supportano anteprima Markdown, modifica esplicita, ricerca e salvataggio automatico. L'anteprima visualizza anche SVG inline e HTML di base incorporati in una nota, sottoposti a sanificazione affinché script, gestori di eventi e URL non sicuri non vengano mai eseguiti. Il pannello degli strumenti delle note aggiunge la cronologia delle revisioni con ripristino, allegati, fissaggio, condivisione per utente (visualizzazione o modifica), esportazione Markdown e una barra laterale per la modifica AI che mostra ogni proposta come diff prima di applicarla; inoltre, poiché l'applicazione crea prima un'istantanea della versione precedente, ogni modifica AI può essere annullata. Le note appartengono all'account e sono incluse nell'archivio completo dell'utente; cronologia delle revisioni e allegati rimangono sull'istanza e non fanno parte dell'archivio.
Rendere più affidabili gli artefatti
Libre WebUI rileva tag espliciti per gli artefatti, blocchi di codice delimitati, documenti HTML autonomi e comuni bundle HTML con più file. Per ottenere da un modello il miglior artefatto possibile, chiedi:
Create one complete self-contained HTML file.
Inline the CSS and JavaScript.
Do not rely on external files unless they are CDN URLs.
Se vuoi blocchi separati, assegna loro nomi chiari:
```html filename="index.html"
...
```
```css filename="style.css"
...
```
```js filename="app.js"
...
```
Libre WebUI proverà a riunire i blocchi CSS e JavaScript locali nell'anteprima HTML.
Accodare prompt durante la generazione di una risposta
Se invii un prompt durante la generazione, viene inserito in coda anziché scartato: i prompt in coda compaiono sopra il compositore, possono essere modificati, riordinati e rimossi, e vengono inviati uno alla volta al termine di ogni risposta. La coda viene salvata insieme alla chat, quindi sopravvive a un ricaricamento o a una riconnessione.
Creare una diramazione di una conversazione
Il pulsante di diramazione presente su ogni messaggio copia in una nuova chat la conversazione fino a quel punto, varianti incluse, e ne registra la provenienza. L'originale resta invariato, così le digressioni esplorative non contaminano mai il filo principale.
Confrontare i modelli in un unico turno
Il pulsante delle colonne accanto al selettore degli strumenti invia il prompt successivo a un massimo di tre modelli aggiuntivi. Ogni risposta costituisce una generazione distinta, con la propria etichetta del modello, le proprie statistiche e il proprio controllo di annullamento; modelli lenti o non funzionanti non bloccano gli altri.
Usare consapevolmente la chat con documenti
La Chat con documenti accetta PDF, file Office (DOCX/PPTX/XLSX), Markdown, HTML, codice e CSV fino a 10 MB. La ricerca funziona in due modalità:
- La ricerca per parole chiave (BM25) è sempre disponibile.
- La ricerca ibrida combina le classifiche semantiche e per parole chiave quando gli embedding sono abilitati nelle Impostazioni ed è disponibile un modello di embedding.
Installa nomic-embed-text se vuoi un modello locale di embedding facile da usare:
ollama pull nomic-embed-text
Per risultati ottimali, carica documenti mirati per ogni chat invece di un unico grande insieme eterogeneo.
Regolare le impostazioni di generazione
| Impostazione | Uso pratico |
|---|---|
| Temperatura | Più bassa per la precisione, più alta per l'esplorazione creativa |
| Top P / Top K | Mantieni i valori predefiniti, a meno che tu non stia regolando il campionamento intenzionalmente |
| Finestra di contesto | Aumentala per le chat lunghe solo se il modello e la memoria lo consentono |
| Token massimi | Limita le risposte lunghe o aumenta il valore per generare codice/artefatti |
| Penalità di ripetizione | Aumentala leggermente quando un modello entra in un ciclo |
Quando un modello si comporta male, prima abbassa la temperatura, poi riduci la pressione sul contesto e infine prova un altro modello.
Decidere quanto deve ragionare un modello
Il controllo accanto al nome del modello nel compositore apre i livelli di ragionamento: disattivato, attivato, basso, medio e alto. La scelta appartiene alla conversazione, quindi sopravvive a un ricaricamento e si applica a una rigenerazione; Impostazioni > Generazione contiene il valore predefinito per le nuove risposte e il pannello dei controlli della chat mostra lo stesso valore.
Se lo lasci non impostato, non viene inviato nulla, come accadeva in tutte le versioni precedenti. Se lo imposti, il server traduce l'unico valore per il provider che risponde: Ollama lo riceve nel corpo della richiesta, i provider in stile OpenAI ricevono un livello di impegno nel ragionamento, mentre Anthropic e Gemini ricevono un budget di token con spazio riservato alla risposta.
Vale la pena conoscere due aspetti. Un modello che Ollama segnala come incapace di ragionare non riceve mai l'impostazione, quindi il controllo semplicemente non compare. Inoltre, i livelli denominati esistono solo sui modelli che li pubblicano, come gpt-oss; su un modello che ragiona senza livelli, un livello denominato si comporta semplicemente come attivato, così una chat che passa da un modello all'altro non genera mai errori per questo motivo. Quando è impostato un valore predefinito globale o fissato, il pulsante del compositore mostra il livello effettivamente usato dalla risposta successiva e la voce "Predefinito" indica il valore a cui corrisponde in quel momento.
Controllare la finestra di contesto
L'anello accanto al nome del modello si riempie con il crescere della conversazione. Passaci sopra per vedere quanto è piena la finestra, i token usati e la capacità totale. Diventa ambra oltre i quattro quinti e rosso al limite della finestra; un modello la cui finestra è sconosciuta mostra un anello tratteggiato anziché vuoto.
Il conteggio comprende ciò che verrà effettivamente inviato dalla richiesta successiva: la cronologia compattata
e le diramazioni abbandonate non hanno alcun costo. Parte dal valore misurato dal provider
per l'ultima risposta, se disponibile, più una stima di quattro caratteri
per token per quanto aggiunto in seguito dalla conversazione, contrassegnata con ~ se non esiste
ancora una misurazione. Se una finestra è limitata al di sotto della capacità per cui il modello è stato addestrato,
viene indicato: l'indicatore misura la finestra effettivamente usata dalla richiesta, ossia
OLLAMA_MAX_CONTEXT (32,768 per impostazione predefinita), non l'intera lunghezza di addestramento
del modello. Aumenta questa variabile e sia la finestra reale sia l'indicatore si adegueranno.
I modelli dei provider mostrano una finestra solo quando il relativo elenco dei modelli ne pubblica una. Quando ciò non accade, l'indicatore continua a contare i token ma non ha un totale per calcolarne la proporzione.
Lasciare che le chat lunghe si compattino automaticamente
Gli amministratori possono attivare la compattazione del contesto in Impostazioni > Generazione. Quando il contesto stimato di una conversazione supera la soglia di token, il server chiede a un modello di riassumere i messaggi meno recenti e conserva integralmente solo quelli più recenti. Il riepilogo appare come scheda di riepilogo della conversazione nel punto in cui la cronologia è stata condensata e i messaggi riepilogati vengono visualizzati attenuati: restano leggibili, ma non vengono più inviati al modello. Con la compattazione attiva, il numero di "messaggi recenti conservati" è anche la finestra mobile inviata dalla conversazione, quindi aumentarlo amplia realmente ciò che vede il modello.
| Impostazione | Cosa controlla |
|---|---|
| Soglia di token | Dimensione stimata del contesto che attiva una compattazione |
| Messaggi recenti conservati | Numero di messaggi più recenti che rimangono sempre integrali |
| Modello di compattazione | Modello che scrive i riepiloghi; usa per impostazione predefinita quello della conversazione |
| Prompt di riepilogo personalizzato | Istruzioni personalizzate, con {{PREVIOUS_SUMMARY}} e {{MESSAGES}} |
La compattazione è disattivata per impostazione predefinita e si applica a tutti gli utenti del server, ma ogni chat mantiene una scelta: il pannello dei controlli può disattivarla per una singola conversazione e ogni scheda di riepilogo dispone di un comando di annullamento. Il ripristino riattiva esattamente i messaggi sostituiti da quel riepilogo, una compattazione alla volta. Un turno non viene mai diviso: i messaggi conservati integralmente iniziano sempre con uno dei tuoi. Ogni nuova compattazione incorpora il riepilogo precedente in quello nuovo, così una conversazione conserva un solo riepilogo progressivo. Se il modello di riepilogo non riesce, la generazione continua con la cronologia non compattata anziché bloccarsi.
Conservare le chiavi dei provider per singolo utente
I plugin dei provider possono leggere le chiavi dall'ambiente, ma le credenziali a livello utente sono solitamente più ordinate nelle installazioni condivise. Aggiungi le chiavi nelle Impostazioni, così ogni utente controlla il proprio accesso ai provider.
Usa le variabili d'ambiente del backend per i valori predefiniti dell'intera distribuzione o per le installazioni automatizzate.
Rendere prevedibile l'accesso remoto
Per l'accesso da telefono o LAN, associa il server di sviluppo all'interfaccia di rete:
npm run dev:host
Quindi, dall'altro dispositivo, apri l'IP LAN o Tailscale della macchina sulla porta 8080 (dev:host serve il frontend sulla 8080, non sulla porta predefinita di Vite). In produzione, imposta esplicitamente CORS_ORIGIN e l'URL API del frontend, così i browser non ripiegano su localhost.
Controllare la versione senza uscire dall'app
Impostazioni → Informazioni confronta la build con l'ultima versione GitHub: indica
quando è aggiornata, collega la pagina della versione quando è obsoleta e segnala
quando una build -dev è più recente della versione fissata. La stessa riga contiene il pulsante
Visualizza registro delle modifiche, che riapre le note di rilascio mostrate dopo l'aggiornamento;
se Libre WebUI ti è utile, il collegamento Aggiungi una stella su GitHub è il modo più semplice
per aiutare altre persone a trovarlo.
Mantenere sincronizzati documentazione e interfaccia
Il prodotto cambia rapidamente. Preferisci una documentazione durevole che descriva comportamenti e flussi di lavoro e lascia che l'interfaccia mostri gli elenchi aggiornati dei modelli dei provider. Evita di copiare lunghi cataloghi di provider nella documentazione, a meno che l'elenco non sia generato dall'app.