AI Setup Guide

Guida alla configurazione
per provider IA

Per utilizzare la funzione di riepilogo IA di ThreadKeeper,
è necessaria una chiave API di uno dei provider IA.
Scegli un provider e segui le istruzioni per la configurazione.

Configurazione di Google Gemini

Piano gratuito disponibile e risposte veloci.
Il provider più consigliato per chi inizia.
Modello consigliato: Gemini 2.0 Flash Lite

1Accedi a Google AI Studio

Vai su https://aistudio.google.com/
e accedi con il tuo account Google.

2Ottieni la chiave API

  1. Clicca su "Get API key" nel menu a sinistra
  2. Clicca sul pulsante "Create API key"
  3. Seleziona un progetto (o creane uno nuovo)
  4. Copia la chiave API visualizzata

La chiave API potrebbe essere visualizzata una sola volta.
Assicurati di copiarla e salvarla in un luogo sicuro.

3Configura in ThreadKeeper

Apri la schermata delle impostazioni di ThreadKeeper,
seleziona "Google Gemini" come "Provider IA".
Incolla la chiave API copiata e salva.

// Esempio file di configurazione (settings.json) { "ai_provider": "gemini", "ai_model": "gemini-2.0-flash-lite", "api_key": "AIza..." }

Informazioni sul piano gratuito: l'API Gemini ha un limite di 15 richieste al minuto
e un limite giornaliero di token.
Per l'uso normale di ThreadKeeper, il piano gratuito è più che sufficiente.

Configurazione di OpenAI

Compatibile con GPT-4o / GPT-4o mini.
Ideale quando serve un riepilogo ad alta precisione.
L'utilizzo dell'API prevede un costo a consumo.

1Accedi a OpenAI Platform

Vai su https://platform.openai.com/
e crea un account o effettua l'accesso.

2Crea una chiave API

  1. Clicca sull'icona in alto a destra → "API keys"
  2. Clicca su "Create new secret key"
  3. Inserisci un nome (es. ThreadKeeper)
  4. Copia la chiave visualizzata

La chiave API viene visualizzata solo al momento della creazione.
Se la perdi, dovrai crearne una nuova.

3Configura il metodo di pagamento

Da Settings → Billing registra un metodo di pagamento.
Sono accettate carte di credito e di debito.

4Configura in ThreadKeeper

Nella schermata delle impostazioni di ThreadKeeper seleziona "OpenAI",
incolla la chiave API e salva.

// Esempio file di configurazione (settings.json) { "ai_provider": "openai", "ai_model": "gpt-4o-mini", "api_key": "sk-..." }

Stima dei costi: con GPT-4o mini,
ogni riepilogo costa circa 0,01-0,03 centesimi.
Anche con 10 utilizzi al giorno, il costo mensile resta sotto 10 centesimi.

Configurazione di Anthropic

Compatibile con Claude 3.5 Sonnet / 3.5 Haiku.
Noto per riepiloghi naturali e accurati.
L'utilizzo dell'API prevede un costo a consumo.

1Accedi ad Anthropic Console

Vai su https://console.anthropic.com/
e crea un account o effettua l'accesso.

2Crea una chiave API

  1. Clicca su "API Keys" nel menu a sinistra
  2. Clicca su "Create Key"
  3. Inserisci un nome (es. ThreadKeeper)
  4. Copia la chiave visualizzata

3Aggiungi credito

Da Settings → Billing acquista credito.
L'acquisto minimo è di $5.

4Configura in ThreadKeeper

Nella schermata delle impostazioni di ThreadKeeper seleziona "Anthropic",
incolla la chiave API e salva.

// Esempio file di configurazione (settings.json) { "ai_provider": "anthropic", "ai_model": "claude-3-5-haiku-latest", "api_key": "sk-ant-..." }

Stima dei costi: con Claude 3.5 Haiku,
ogni riepilogo costa circa 0,02-0,05 centesimi.

Configurazione di Ollama

Funziona completamente offline e gratuitamente.
Nessun dato viene mai inviato all'esterno.
Richiede un PC con specifiche adeguate.

1Installa Ollama

Scarica e installa la versione Windows
da https://ollama.com/.

2Scarica un modello

Apri il Prompt dei comandi o PowerShell
ed esegui i seguenti comandi.

# Consigliato: leggero e veloce ollama pull gemma3:4b # Per riepiloghi di alta qualità ollama pull llama3.2 # Modello forte nelle lingue europee ollama pull qwen2.5:7b

Specifiche richieste: per il modello 4B,
si consiglia almeno 8GB di RAM.
Per il modello 7B, 16GB o più di RAM per un uso confortevole.

3Avvia Ollama

Dopo l'installazione, Ollama si avvia
automaticamente in background.
Se vedi l'icona di Ollama nella barra delle applicazioni, è tutto a posto.

4Configura in ThreadKeeper

Nella schermata delle impostazioni di ThreadKeeper seleziona "Ollama".
Non serve una chiave API. Basta configurare il nome del modello.

// Esempio file di configurazione (settings.json) { "ai_provider": "ollama", "ai_model": "gemma3:4b", "ollama_url": "http://localhost:11434" }

Con Ollama, il download del modello
potrebbe richiedere da alcuni minuti a diverse decine di minuti.
Solo la prima volta richiede tempo; in seguito funziona immediatamente offline.

Note comuni

Gestione delle chiavi API
Le chiavi API vengono salvate localmente
nel file di configurazione di ThreadKeeper.
Non vengono mai inviate ai server di ThreadKeeper.
Non condividere le chiavi API con altri.

Dati inviati
I dati inviati all'IA includono solo i titoli delle app aperte,
i titoli e gli URL dei tab del browser
e i primi 200 caratteri degli appunti.
Il contenuto dei file e le password non vengono inviati.
Con Ollama, nessun dato viene inviato all'esterno.

Cambio di provider
Puoi cambiare provider in qualsiasi momento dalle impostazioni.
I dati delle sessioni non dipendono dal provider,
quindi i dati precedenti vengono mantenuti anche dopo il cambio.