# Manuale Utente - DeepResearcher AI 🔬 **DeepResearcher AI** è un'applicazione "Universale" progettata per trasformare il tuo LLM locale (tramite Ollama) in un agente di ricerca autonomo. A differenza di una semplice chat, DeepResearcher pianifica, scrive e assembla documenti complessi in modo strutturato. ## 🚀 Installazione e Requisiti 1. **Ollama**: Deve essere installato e in esecuzione sul tuo computer. * Comando terminale: `ollama serve` * Verifica: Apri il browser su `http://localhost:11434`. Se vedi "Ollama is running", sei pronto. 2. **Modelli**: Assicurati di aver scaricato almeno un modello (es. `llama3`, `mistral`, `gemma`). * Comando: `ollama pull llama3` ## 🖥️ Interfaccia Principale * **Modello LLM**: Seleziona il cervello dell'operazione. Modelli più grandi (es. 70b) danno risultati migliori ma sono più lenti. * **Argomento di Ricerca**: Sii specifico. Invece di "Storia", scrivi "Storia dell'evoluzione dei computer quantistici dagli anni '80 a oggi". * **Profondità di Ricerca**: Il cuore dell'applicazione. ## ⚙️ Modalità di Ricerca ### 1. Standard (Veloce) Ideale per overview rapide o articoli di blog. * **Processo**: Genera un Indice -> Scrive una sezione per ogni punto. * **Output**: ~1.000 parole. * **Tempo**: 1-2 minuti. ### 2. Deep (Approfondita) Ideale per tesine o report tecnici. * **Processo**: Come la Standard, ma istruisce il modello a essere "accademico, denso ed esaustivo" per ogni sezione. * **Output**: ~3.000 parole. * **Tempo**: 5-10 minuti. ### 3. ULTRA (Ricorsiva / "God Mode") 🚀 Ideale per **libri**, **thesis draft** o guide complete. Sfrutta una logica frattale. * **Processo**: 1. **Macro-Struttura**: L'IA definisce i CAPITOLI del libro. 2. **Micro-Struttura**: Per *ogni* capitolo, l'IA genera i titoli dei PARAGRAFI. 3. **Drafting**: L'IA scrive il contenuto di ogni singolo paragrafo, mantenendo il contesto del capitolo. 4. **Assemblaggio**: Unisce decine di pezzi in un unico documento coerente. * **Output**: 5.000 - 10.000+ parole. * **Tempo**: 15-30 minuti (dipende dalla velocità del tuo PC). ## 🛡️ Funzionalità Anti-Allucinazione (Source Context) Se vuoi evitare che l'IA "inventi" (allucinazioni), usa questa funzione: * **Contesto / Fonte**: Incolla nel box apposito il testo di riferimento (es. il contenuto di un articolo, appunti, un PDF copiato). * **Modalità Rigida**: Spunta questa casella per obbligare l'IA a usare **SOLO** le informazioni presenti nel box Fonte. Se un'informazione manca, te lo dirà invece di inventarla. * **Bibliografia Safe**: In questa modalità, la bibliografia non verrà generata randomicamente ma sarà limitata alla fonte fornita. ## 📝 Funzionalità Aggiuntive * **Export Markdown**: Al termine della generazione, il pulsante si attiva. Scarica un file `.md` formattato, pronto per essere convertito in PDF, Word o pubblicato sul web. * **Sitografia/Bibliografia**: Alla fine di ogni report, l'IA genera una lista di fonti (Libri classici e Domini web). * *Attenzione*: Poiché il modello lavora offline, le fonti sono basate sulla sua "memoria" di addestramento. Verifica sempre i titoli specifici. ## 💡 Consigli per Risultati Migliori 1. **Sii Specifico nel Prompt**: Un argomento vago ("Il Mare") produce risultati generici. Un argomento dettagliato ("L'impatto ecologico delle microplastiche nel Mediterraneo") produce report di alta qualità. 2. **Usa Modelli "Instruct"**: Modelli come `llama3:instruct` o `mistral:instruct` seguono meglio le istruzioni di formattazione rispetto ai modelli base. 3. **Pazienza in Ultra Mode**: Non chiudere la finestra. Se sembra bloccato, guarda l'icona di caricamento (spinner) accanto allo step corrente. ## 🛠️ Risoluzione Problemi * **"Errore Connessione"**: Assicurati che Ollama sia attivo (`ollama serve`). A volte i browser bloccano le connessioni locali (CORS); in tal caso, consulta la guida di installazione di Ollama per abilitare le origini `null` o `*`. * **Il testo si interrompe**: Prova a usare un modello con una finestra di contesto più ampia o seleziona una modalità meno profonda se il tuo hardware è limitato (poca VRAM).