Guida all'installazione dell'estensione TuaGPT per Chrome

Questa guida ti spiega come installare e attivare l'estensione TuaGPT Web Assistant su Chrome per integrare il browser con l'applicazione desktop TuaGPT.

Requisiti

Browser Chrome o Edge (versione recente)
Applicazione desktop TuaGPT installata sul computer

1. Installa l'estensione

Vai su Chrome Web Store e cerca TuaGPT Web Assistant oppure apri direttamente la pagina dell'estensione (se disponibile).
Clicca su Aggiungi a Chrome.
Conferma cliccando su Aggiungi estensione nella finestra di dialogo.
L'icona di TuaGPT apparirà nella barra degli strumenti di Chrome (puoi fissarla cliccando sull'icona del puzzle e poi sulla puntina accanto a TuaGPT Web Assistant).

2. Ottieni il token da TuaGPT

Apri l'applicazione TuaGPT sul computer.
Vai in Impostazioni → Tool LLM → sezione Estensione Browser.
Spunta Abilita Estensione Browser per Accesso Web.
Prendi nota della Porta (di solito 8765).
Clicca su Copia per copiare il Token di autenticazione negli appunti.

Nota: Se cambi il token in TuaGPT (pulsante Rigenera), dovrai aggiornarlo anche nell'estensione.

3. Configura l'estensione

Clicca sull'icona di TuaGPT Web Assistant nella barra di Chrome (accanto alla barra degli indirizzi).
Si aprirà un popup. Inserisci:
- Porta Server: 8765 (o la porta mostrata in TuaGPT)
- Token Autenticazione: incolla il token copiato da TuaGPT (Ctrl+V)
Clicca su Test Connessione per verificare che tutto funzioni (deve apparire un messaggio di successo verde).
Clicca su Salva per memorizzare la configurazione.

Se il test fallisce, assicurati che TuaGPT sia aperto e che "Abilita Estensione Browser" sia attiva nelle Impostazioni.

4. Utilizzo

Una volta configurata, l'estensione funziona automaticamente. Non serve fare nulla manualmente nel browser: quando TuaGPT ha bisogno di cercare sul web o di leggere una pagina, invierà le richieste all'estensione, che le eseguirà nel browser e restituirà i risultati a TuaGPT.

Affinché tutto funzioni, durante l'utilizzo di TuaGPT:

Chrome deve essere aperto (anche in background)
TuaGPT deve essere in esecuzione con l'opzione Estensione Browser abilitata

L'estensione comunica solo con TuaGPT sul tuo computer (localhost). Nessun dato viene inviato a server esterni.

Risoluzione problemi

Test connessione fallito: Verifica che TuaGPT sia aperto, che "Abilita Estensione Browser" sia attiva e che porta e token siano corretti.
L'estensione non risponde: Prova a chiudere e riaprire Chrome, o a disabilitare e riattivare l'estensione in chrome://extensions.
Token non valido: Rigenera il token in TuaGPT (pulsante Rigenera) e aggiornalo nell'estensione.

Per ulteriori informazioni su TuaGPT e sull'estensione, consulta la documentazione dell'applicazione.