Samuraizer — Motore di Knowledge Base per la Cyber‑Sicurezza

💡 Perché Samuraizer?

Ogni ricercatore di sicurezza conosce la sensazione — trovi un repository GitHub interessante, un nuovo writeup di CVE, un articolo su una tecnica di sfruttamento. Lo invii a te stesso su WhatsApp. Immediatamente affonda nella chat. Settimane dopo ti serve quell'articolo — ed è sparito.

Smetti di inviarti link che non troverai mai più — inviali a Samuraizer una volta, e saranno riassunti, etichettati e ricercabili per sempre.

🔐 Privacy local-first (funzionalità solo locale)

🎯 Modalità privacy extra (solo locale) — esegui con ollama, tutti i dati rimangono sulla tua macchina.

• 🗄️ Archiviazione vettoriale locale in samuraizer.db + embedding AI locali tramite Ollama.
• ⚡ Funziona completamente offline una volta scaricati i modelli (ollama pull qwen3:4b, ollama pull qwen3-embedding:8b).
• ✅ Ottimo per team di sicurezza e ricercatori che necessitano di configurazioni air-gapped/isolate.

---

🧩 Cosa ottieni (a colpo d'occhio)

🔍 Analizza — Incolla URL, guarda i risultati in streaming

• 📝 Incolla uno o più URL (repository GitHub, writeup di CVE, post su blog, video YouTube) — i risultati arrivano in tempo reale
• 📄 Carica file direttamente dal browser o da Telegram — il testo completo viene estratto, analizzato, archiviato e visualizzabile nell'interfaccia
  • formati supportati: .pdf, .docx, .pptx, .txt, .md
• 🗞️ Scanner di blog: incolla la homepage di un blog ed estrai tutti i link degli articoli per un'analisi batch in un clic
• ✨ Lettura suggerita: ogni sessione viene proposta una voce non letta pertinente nella scheda Analizza per mantenere attiva la coda

🗂️ Knowledge Base

• ✏️ Modifica tag inline (aggiungi/rimuovi tag su voci, feed e elementi della lista)
• 🔎 Ricerca semantica (ricerca vettoriale tramite embedding Gemini) + ricerca full-text classica
• 🧩 Nuvola di tag + multi-filtro (per tag, categoria, fonte, lista, letto/utile)
• 📚 Gestione liste — raggruppa voci in liste manuali, liste RSS o liste di canali
• 👁️‍🗨️ Anteprima al passaggio del mouse (schede riassuntive) e pulsanti di copia rapida

🗺️ Knowledge Graph

• Visualizza l'intera knowledge base come un grafo interattivo a forza diretta
• Voci e tag sono nodi — gli archi mostrano quali tag collegano quali articoli
• Clicca per vedere un'anteprima; doppio clic per aprire l'URL originale
• Codice colore per categoria (CVE, articolo, strumento, video, blog, ecc.)
• Cerca tag per evidenziare cluster correlati sull'intero grafo

📡 Feed RSS e Abbonamenti YouTube

• Aggiungi feed RSS/Atom — il server li verifica ogni ora e importa e riassume automaticamente i nuovi post
• I nuovi post vengono aggiunti automaticamente alla Knowledge Base
• Ogni feed diventa una propria lista, facilitando la revisione batch
• Gli elementi del feed mostrano metadati della fonte e possono essere etichettati/filtrati come qualsiasi altra voce

🎥 Abbonamenti ai Canali YouTube

• Iscriviti a canali YouTube tramite URL (es. https://www.youtube.com/@handle, /channel/UCxxx)
• Anteprima degli ultimi video prima di iscriversi e seleziona quali video analizzare
• All'iscrizione, i video selezionati vengono analizzati immediatamente; i caricamenti futuri vengono verificati automaticamente ogni ora
• Funziona tramite API /yt-channels e appare nell'interfaccia sotto le sezioni RSS/YT

🤖 Bot Telegram (Opzionale)

• Invia qualsiasi URL al bot — lo analizza attraverso lo stesso backend e restituisce una scheda formattata
• Invia un file PDF — lo scarica, analizza e restituisce una scheda con un link per visualizzare/scaricare il file
• Aggiornamenti sull'avanzamento in tempo reale durante l'analisi
• Riceve una notifica di Lettura Suggerita — il bot propone attivamente voci non lette

💬 Chat (RAG + streaming + contesto bloccato)

• Fai domande sulla tua knowledge base — le risposte sono citate dalle voci più pertinenti
• ⚡ Risposte in streaming con digitazione live e punteggi di pertinenza per fonte
• 🗂️ Sessioni chat multiple con cronologia salvata e selezione del modello
• 📌 Blocca articoli specifici come contesto — digita @ per il completamento automatico o usa il pulsante di navigazione @
  • Quando le voci sono bloccate, Gemini risponde solo da quegli articoli — nessun rumore RAG
  • Le voci bloccate appaiono come chip sopra l'input; le fonti mostrano un badge 📌 invece di un punteggio
  • Perfetto per approfondire un PDF, un writeup o un CVE specifico

[!IMPORTANT] Plasma il futuro di Samuraizer! Stiamo votando nuove funzionalità come LLM locali ed esportazione Obsidian. Vota qui!

---

🏗 Architettura (alto livello)