Uso di Banana

Funzioni di conversazione e di studio.

Memoria

Banana ricorda da sola le informazioni personali che le dici (nome, studi, lavoro, preferenze...). Ogni messaggio che sembra contenere dati personali provoca una breve chiamata aggiuntiva al modello, in background, per estrarre i fatti.

Comando	Effetto
/ricorda <testo>	salva un fatto a mano
/memoria	elenca i fatti salvati
/dimentica <n>	cancella il fatto numero n
/dimentica tutto	svuota la memoria

La memoria è salvata nel browser (localStorage): cancellando i dati del sito o cambiando browser si perde. Contiene al massimo 50 voci. Un modello piccolo può estrarre fatti imprecisi: controlla con /memoria e correggi con /dimentica.

Ragionamento

• Spento di default (--reasoning off), per risposte molto più rapide.
• Si attiva dal menu + → Ragionamento, con tutti e tre i modelli.
• Su Qwen3 è il ragionamento nativo, mostrato in un riquadro separato (<think>).
• Su Qwen2.5-Omni, che non lo supporta nativamente, viene chiesto ad Banana nel prompt di ragionare passo per passo: il ragionamento compare nel testo della risposta.
• /no_think all'inizio del messaggio forza la risposta immediata sui Qwen3.

Ricerca web

Il pulsante Web, accanto al + nel riquadro dei messaggi, attiva la ricerca (si illumina quando è attiva e il suo stato viene ricordato).

• Con la ricerca attiva, ogni domanda viene prima cercata su DuckDuckGo; i primi 5 risultati (titolo, estratto, indirizzo) e la data di oggi vengono passati ad Banana, che risponde citando le fonti con [1], [2] e un elenco finale «Fonti».
• Serve la connessione a internet. Se la ricerca non riesce, Banana lo dice e risponde con ciò che sa.
• Non usa il tool-calling dei modelli (inaffidabile sui modelli piccoli): la ricerca la fa sempre la UI, quindi funziona con tutti e tre i modelli.
• Ogni ricerca aggiunge circa 500 token di contesto alla domanda; per questo il contesto è di 4096 token. I risultati valgono solo per la domanda corrente.
• Banana può sbagliare a interpretare i risultati: controlla le fonti per informazioni importanti.
• I comandi che iniziano con / non attivano la ricerca.

Riassumi pagine e documenti

Cosa	Come
Pagina web o PDF online	scrivi riassumi https://indirizzo (anche sintetizza, riepiloga); il messaggio deve essere breve e iniziare con la richiesta. Se l'indirizzo è un PDF, Banana lo scarica (max 15 MB) e ne estrae il testo
File allegato alla chat	allega un PDF o un file di testo con la graffetta e scrivi riassumi: gli allegati vengono riassunti e non occupano il contesto
Documento caricato	Doc → cappello accanto al file → Riassunto completo

Il contesto è di soli 4096 token, quindi il testo viene diviso in blocchi da ~2800 caratteri: ogni blocco viene riassunto a parte (3 punti, in background, avanzamento in un avviso in basso) e i riassunti parziali vengono uniti in un riassunto finale, risposto in streaming. Un testo breve viene riassunto in un solo passaggio.

• Limite: i primi 6 blocchi (~17.000 caratteri); se il testo è più lungo, Banana lo dice nella risposta.
• Per le pagine, search_server.py scarica l'indirizzo (/fetch) ed estrae il testo leggibile. Solo http/https verso indirizzi pubblici: rete locale e localhost sono bloccati. La pagina viene scaricata solo quando lo chiedi.
• I PDF online sono supportati (search_server.py, endpoint /pdf); le scansioni senza testo no. Pagine che richiedono login o che costruiscono il testo con JavaScript possono risultare vuote.
• Tempi su CPU: circa 1 minuto per blocco con il 4B (meno con il 1.7B). Il messaggio inviato mostra i riassunti parziali usati.

Timer e promemoria

I comandi in italiano sono riconosciuti direttamente dall'interfaccia (senza chiedere al modello, che sbaglierebbe orari e calcoli) e non vengono inviati alla chat.

Scrivi	Effetto
timer 10 minuti · timer di 1 ora e 30 minuti per la pasta · timer di mezz'ora	timer con eventuale etichetta
ricordami tra 20 minuti di chiamare Marco · tra un'ora e mezza · tra tre giorni	promemoria a distanza
ricordami alle 18:30 di ... · alle 9 e mezza · a mezzogiorno · stasera alle 9	orario di oggi (se già passato, domani)
ricordami domani alle 9 di ... · lunedì alle 8 · dopodomani	giorno + ora; senza ora: 09:00 (21:00 per "stasera")
sveglia alle 7:30 · imposta una sveglia domani alle 6	promemoria "Sveglia!"
/promemoria · quali promemoria ho?	elenco di quelli attivi
annulla tutti i timer	cancella tutti i promemoria e i timer

• A scadenza: notifica di sistema + suono + voce (su macOS la voce italiana Alice, offline). Funziona anche con la scheda del browser chiusa, finché actions_server.py è in esecuzione.
• Sono salvati in ~/Banana/data/reminders.json e sopravvivono al riavvio; se scadono mentre Banana è spenta, suonano all'avvio con "(in ritardo)".
• Massimo 50 attivi, fino a un anno nel futuro. Non serve attivare Azioni: sono comandi diretti tuoi, non del modello.
• Se la notifica non compare, abilita le notifiche per Script Editor in Impostazioni di Sistema → Notifiche (il suono e la voce funzionano comunque).

Documenti locali (RAG)

Il pulsante Doc, accanto a Web, apre la libreria dei documenti.

• Aggiungi documento: PDF e file di testo (.txt, .md, .csv, codice...). Il testo viene estratto e diviso in estratti; resta nel browser (IndexedDB) e non viene inviato a nessuno.
• Ogni domanda cerca gli estratti più pertinenti (fino a 4, ~2600 caratteri) e li passa ad Banana, che risponde citando file e pagina, es. (manuale.pdf, p. 3). Se la risposta non è nei documenti, lo dice.
• L'interruttore Usa i documenti nelle risposte li attiva o disattiva senza cancellarli; il cestino rimuove un documento.
• La ricerca è per parole chiave: funziona meglio se la domanda usa le stesse parole del testo. Le scansioni (PDF di sole immagini) non hanno testo e non vengono lette.
• Compatibile con la ricerca web: se sono attivi entrambi, Banana riceve estratti dei documenti e risultati web.
• Sono documenti nel browser: cancellando i dati del sito si perdono.

Ricerca nelle chat passate

Il pulsante Storico (accanto ad Auto) fa cercare ad Banana anche nelle tue altre conversazioni. A ogni domanda, una ricerca per parole chiave (BM25, tutto in locale) sceglie fino a 3 messaggi pertinenti di altre chat e li passa ad Banana, che li usa solo se servono e cita il titolo della chat.

• Cerca in tutte le chat tranne quella corrente (un estratto per chat); se non c'è nulla di pertinente non aggiunge niente.
• L'indice si costruisce al primo uso e si aggiorna ogni ~45 secondi; con molte chat il primo avvio può richiedere un attimo.
• Funziona meglio se la domanda usa le stesse parole della conversazione cercata. Disattivato di default.
• Compatibile con Web e Doc: se sono attivi insieme, Banana riceve tutte le fonti.

Appunti da lezione

Nella finestra Doc, il cappello accanto a ogni documento apre lo studio:

Passo	Cosa fa
Da pagina	sceglie da dove iniziare; Banana prende circa 3000 caratteri (qualche pagina) alla volta
Riassunto	punti elenco con concetti e formule principali
Flashcard	8 coppie domanda/risposta (D: / R:)
Quiz	5 domande a risposta multipla con risposta corretta e spiegazione

Il testo dell'estratto viene inserito direttamente nel messaggio (senza ricerca per parole chiave), quindi la risposta si basa solo su quella parte: per continuare imposta la pagina successiva. Con Auto attivo la richiesta va al Qwen3-4B, più accurato del 1.7B.

Immagini e audio

Seleziona Qwen2.5-Omni-3B nel selettore del modello, poi usa + → Aggiungi file. Con gli altri modelli il caricamento di immagini e audio è disattivato. Il video non è stato testato.

Analisi video

llama.cpp non legge i video: quando ne alleghi uno (+ → Video, o trascinandolo) Banana lo trasforma nel browser in 3-6 fotogrammi (JPEG, in ordine, lato massimo 448 px, uno ogni ~5 s) più l'audio (WAV mono 16 kHz, primi 30 s; assente oltre i 5 minuti di video o se silenzioso). Poi scrivi la domanda (es. cosa succede in questo video?).

• Serve il modello Qwen2.5-Omni (immagini e audio). Con Auto attivo puoi allegare immagini, audio e video anche se è selezionato un altro modello: all'invio Banana passa da sola a Omni.
• È un campionamento, non una visione continua: azioni brevi tra due fotogrammi possono sfuggire.
• Con 4096 token di contesto 6 fotogrammi e 30 s di audio occupano buona parte del contesto: usa video brevi.
• Tutto avviene sul Mac; il video non viene inviato a nessuno. Limite 500 MB.

Scelta automatica del modello

Il pulsante Auto (accanto a Doc) sceglie il modello per ogni messaggio:

Messaggio	Modello
Domanda breve/semplice	Qwen3-1.7B (veloce)
Testo lungo, codice, spiegazioni/analisi/calcoli, o con Web/Doc attivi	Qwen3-4B
Immagini, audio o video allegati	Qwen2.5-Omni-3B

Cambiare modello richiede qualche secondo di caricamento (ne resta uno solo in RAM). Disattivato di default; la scelta si ricorda nel browser.

Memoria su file

Memoria, progetti e documenti vengono copiati automaticamente in ~/Banana/data/ (cambiabile con la variabile BANANA_DATA). All'apertura, se il browser è vuoto (dati cancellati, altro browser) o il file è più recente, Banana li ricarica dal file; altrimenti aggiorna il file. Se il servizio non è attivo, tutto funziona come prima solo nel browser. Le conversazioni restano nel browser: per queste usa l'esportazione ZIP.

Backup (esporta/importa)

Impostazioni → Importa/Esporta:

Cosa	Formato	Note
Conversazioni	ZIP di JSONL	importazione con unione alle esistenti
Memoria e documenti (Doc)	JSON (banana_backup_AAAA-MM-GG.json)	importazione senza duplicati
Impostazioni	JSON	chiavi sensibili escluse di default

Usalo per spostare Banana su un altro browser o prima di cancellare i dati del sito.