Archivio

Sul tuo computer, in italiano

Chiedi ai tuoi documenti. Ti risponde con la pagina.

Dai ad Archivio una cartella di contratti o verbali, e fagli una domanda come la faresti a un collega. Ogni affermazione della risposta porta il documento e la pagina da cui viene. Se l'informazione non c'è, lo dice.

Installalo Il codice su GitHub

Domanda

Con quanto preavviso va disdetto l'affitto del magazzino?

Risposta

Tre mesi, con raccomandata o PEC . Il contratto del 2019 chiedeva sei mesi , ma il rinnovo del 2024 li ha ridotti, ed è la versione in vigore.

  • E1Contratto_locazione_magazzino_2019.pdf · pagina 4«…disdetta da comunicarsi con almeno sei mesi di preavviso…»
  • E2Rinnovo_locazione_2024.pdf · pagina 2«…il termine di preavviso di cui all'art. 7 è ridotto a tre mesi…»
2 citazioni verificate 2 versioni: vale il 2024

Un esempio con documenti inventati. Passa sopra le etichette per vedere da dove viene ogni frase.

Come lavora

Un modello che risponde a memoria inventa con la stessa sicurezza con cui dice il vero. Archivio lo costringe a leggere, e poi controlla che abbia letto.

  1. Legge la cartella

    PDF, Word, testo, CSV. Le pagine scansionate passano dall'OCR. Gli originali si aprono solo in lettura.

  2. Cerca in due modi

    Per parole, che trova codici, importi e nomi. Per significato, che trova lo stesso concetto detto con altre parole.

  3. Fa leggere il modello

    Se i documenti gli stanno in memoria, li legge tutti. Altrimenti legge le pagine intere più pertinenti.

  4. Controlla la risposta

    Citazioni che non esistono, frasi senza fonte, un documento superato da una versione più recente.

Cosa fa

  • Gira con modelli locali, con Ollama o LM Studio. I documenti non escono dal computer.
  • Calcola sempre in locale i vettori di significato, qualunque modello risponda.
  • Toglie dai documenti le frasi che danno ordini a un'AI, prima che arrivino al modello, e te le mostra.
  • Si accorge da solo dei file nuovi o cambiati nella cartella.

Cosa non promette

  • Non sostituisce la lettura del documento quando la decisione conta. Ti dice dove guardare.
  • Con OpenRouter gli estratti escono dal computer. L'app lo dice con una fascia rossa, ma la scelta resta tua.
  • Un modello piccolo sbaglia di più. Il controllo delle citazioni lo rende visibile, non impossibile.

Una risposta senza pagina è un'opinione. Con la pagina, è un fatto che puoi controllare.

Per cominciare

Provato su Mac con Apple Silicon. Tre programmi da installare una volta sola, poi un comando.

1 · uv

Prepara le librerie e avvia l'app.

brew install uv

2 · Ollama e due modelli

Da ollama.com. Uno calcola i vettori, l'altro risponde.

ollama pull qwen3-embedding:0.6b
ollama pull hf.co/XHToken/Spark-X2.5-4B-GGUF:Q8_0

3 · Tesseract, se serve

Solo per i PDF scansionati.

brew install tesseract tesseract-lang

Scarica il progetto da GitHub (Code → Download ZIP), apri il Terminale nella sua cartella e avvialo:

uv run archivio.py   # si apre http://127.0.0.1:4100

Dall'area admin, su /admin, scegli la cartella dei documenti. La prima indicizzazione richiede qualche minuto, poi le domande partono subito.

Collegarlo a un altro programma

Archivio parla anche MCP, il protocollo con cui un'AI usa strumenti esterni. In Unsloth Studio: Add custom MCP, poi l'indirizzo, senza autenticazione. Gli strumenti sono tre: descrivere l'archivio, cercare nei documenti, leggere una pagina.

  • Con l'app accesahttp://127.0.0.1:4100/mcp/documenti
  • Da solo, con uv run server_mcp_documenti.pyhttp://127.0.0.1:4101/mcp