Private Knowledge Hub
CompletatoLocale / Privato — nessuna demo liveSistema di recupero documenti locale per file di progetto privati. Indicizza file CLAUDE.md, README e SKILL.md di oltre 10 progetti e risponde a domande in linguaggio naturale con riferimenti alle fonti ancorati e output markdown formattato.
Tecnologie
Problema
Oltre 65 documenti di progetto personali (file CLAUDE.md, README, SKILL.md, file di codice) sono distribuiti su più repository. Nessuna interfaccia unificata per interrogare le conoscenze tra i progetti o recuperare contesto su richiesta.
Approccio
FolderIngester con ricerca ricorsiva nelle cartelle, 18 tipi di file supportati, deduplicazione SHA-256 e limite di 50 MB. MarkdownLoader con pipeline di pulizia regex (rimuove ##, **, sintassi delle tabelle) prima dell'embedding per migliori punteggi di similarità. Soglia di similarità calibrata a 0,25 — i documenti markdown ottengono punteggi più bassi dei PDF in prosa. Scalato tramite app_name="private_hub" nel database pgvector condiviso su AWS RDS.
Risultato
65+ documenti di progetto personali indicizzati. FastAPI in locale su localhost:8001 — completamente separato dalla demo RAG pubblica. Eliminazione e de-indicizzazione per documento con pulizia a cascata di chunk ed embedding. Risposte renderizzate come markdown formattato tramite marked.js.
Apprendimenti
La soglia di similarità dipende dal tipo di documento: i documenti markdown con sintassi strutturale ottengono punteggi più bassi dei PDF in prosa — la pulizia prima dell'embedding migliora misurabilmente la qualità del recupero. Il scoping tramite app_name consente il riutilizzo multi-tenant di un database pgvector condiviso senza mescolanza di dati.
Rilevanza
Dimostra strumenti IA privacy-first, il riutilizzo pratico di infrastrutture condivise e la costruzione di strumenti di produttività personali per i knowledge worker — senza dipendenze esterne o deployment cloud per contenuti privati.