Germano AI - Anonimizzazione Documentale Intelligente

Casi d'Uso

Due Modalità Potenti, Un Unico Scudo Privacy.

Usa Germano AI per bonificare interi archivi documentali in locale oppure come filtro trasparente in tempo reale tra i tuoi strumenti di lavoro e le AI sul cloud.

Caso d'Uso 1 • Batch Standalone & NAS

Anonimizzazione Massiva di Cartelle e Archivi Documentali

Hai semplicemente un gran numero di documenti da anonimizzare sul tuo computer o server o NAS. Germano funziona in modalità standalone e restituisce i documenti anonimizzati; supporta molti formati ed è altamente configurabile. Tu semplicemente copi la cartella contenente i file dentro ad input e ricevi i file anonimizzati nella cartella output. Germano mantiene la struttura della directory e delle sottocartelle originali. Germano anonimizza testo, prompt e volti ed è compatibile con il GDPR; Germano è un'applicazione Windows locale e offline (non richiede accesso ad internet per funzionare).

/input/** Germano Offline /output/**

Caso d'Uso 2 • Proxy API Locale per LLM

Usa ChatGPT, Claude, Gemini e Cursor senza Inviare Dati Sensibili

Vuoi usare la potenza di un LLM online (ChatGPT, Gemini, Claude, Copilot, DeepSeek..) ma i tuoi documenti o il testo che scrivi nel prompt contengono dati personali che non vuoi o non puoi inviare all'AI (come da normativa vigente per la Pubblica Amministrazione)? Germano anonimizza questi dati per te integrandosi perfettamente fungendo da Proxy API Locale con gli strumenti che già usi: Claude Code, Google Antigravity, OpenCode, Cursor e tutti gli altri. Se sul prompt scrivi "Mario Rossi" se ne accorge e lo sostituisce con [PERSONA_1] prima che venga inviato all'LLM online. In questo modo l'AI online avrà in input solo i documenti e i testi anonimizzati.

Cursor / Antigravity Proxy :8000 Cloud LLM

Architettura Tecnologica

Cos'è Germano AI?

Un motore neurale e biometrico completo che gira interamente sul tuo hardware, progettato per non alterare mai l'impaginazione dei tuoi documenti.

Intelligenza Artificiale Locale

6 modelli IA locali (linguaggio, OCR e visione) che girano direttamente sul tuo processore, anche su un PC senza scheda video. I tuoi dati non lasciano mai il tuo ufficio.

openai/privacy-filter Italian NER XXL PyTorch CPU / CUDA

Multi-Formato e "In-Place"

Elabora PDF, Word, Excel, PowerPoint, OpenDocument, RTF, email, ZIP e file firmati .p7m mantenendo intatti layout, formattazione, immagini, tabelle e persino le macro VBA.

PDF Redaction Office / ODF / RTF P7M · EML · ZIP

Censura Testuale & Visiva (Biometria)

Intercetta dati sensibili nel testo. Nei PDF o nelle immagini (es. Carta di Identità), usa reti neurali locali per oscurare volti, firme autografe e targhe e l'OCR per leggere e censurare i dati anagrafici stampati.

YuNet Face DNN EasyOCR RegEx Validate (CF, IBAN)

Governance & Sicurezza

Profili di Conformità

Germano AI è progettato per adattarsi sia ad ambienti altamente regolamentati che a professionisti privati.

Germano PA (Pubblica Amministrazione)

A Norma CAD/GDPR

Filtri di censura bloccati e attivi al 100%.
Nessuna possibilità di disabilitare l'OCR o la biometria facciale per garantire sicurezza assoluta.
Garantisce il rispetto del GDPR (Regolamento UE 2016/679) sulla minimizzazione dei dati e del CAD (Codice dell'Amministrazione Digitale) per la gestione documentale.

Germano PD (Pubblico Dominio)

Configurazione Libera

Totale controllo su quali filtri (nomi, email, ecc.) attivare.
Soglia di affidabilità dell'Intelligenza Artificiale regolabile a piacimento.
Ideale per aziende private, avvocati e ricercatori che necessitano di flessibilità operativa.

Zero-Trust AI Proxy

Sblocca il potere di ChatGPT, Claude, Gemini, DeepSeek e molti altri (in sicurezza)

Molte Pubbliche Amministrazioni e aziende esitano a utilizzare i Large Language Models commerciali per paura di inviare prompt o documenti contenenti Dati Personali Identificabili (PII) su server cloud esteri. Grazie all'innovativa integrazione tramite API Proxy Locale, Germano AI si interpone automaticamente tra il tuo editor AI (come Cursor o Antigravity) e i server cloud.

Il tuo Prompt e Documenti

Contengono dati sensibili originali...

Germano API Proxy (Offline)

Censura tutto al volo

LLM (Cloud)

Elaborazione purificata

L'Intelligenza Artificiale online non entrerà mai in contatto con i dati reali originali. Tu puoi scrivere prompt estremamente specifici senza preoccuparti di violare il GDPR, lasciando che il Proxy li "purifichi" prima dell'invio.

Maggiori Dettagli (Scudo Privacy)

Developer & Enterprise Ready

Integrazione REST API

Germano AI non è solo una Dashboard. Integra il motore di anonimizzazione direttamente nei tuoi flussi documentali (CRM, ERP, Protocollo Informatico) tramite le nostre veloci API locali.

Endpoint Sincrono Binario: invia un PDF/DOCX via POST e ricevi direttamente lo stream del file anonimizzato.
Proxy OpenAI & Anthropic: http://127.0.0.1:8000/v1 per Cursor, Codex e Antigravity, http://127.0.0.1:8000 per Claude Code. Streaming, immagini, PDF e tool supportati.
Audit Log JSON Completo: tracciamento puntuale di ogni entità oscurata nella cartella /extracted.

Manuale e Documentazione

# Invia un documento al motore locale Germano AI curl -X POST http://127.0.0.1:8000/api/v1/anonymize \ -F "file=@/percorso/contratti/delibera_comunale.pdf" \ --output delibera_anonimizzata.pdf # HTTP/1.1 200 OK # Content-Type: application/pdf # Content-Disposition: attachment; filename=delibera_comunale.pdf # Report di audit: extracted/api/20261022-104107_delibera_comunale.pdf.json

# Claude Code (formato Anthropic) - PowerShell $env:ANTHROPIC_BASE_URL = "http://127.0.0.1:8000" claude # Codex CLI / Cursor / Antigravity (formato OpenAI) $env:OPENAI_BASE_URL = "http://127.0.0.1:8000/v1" codex # La tua API key resta quella vera: Germano la usa solo # per inoltrare la richiesta già anonimizzata. # 🛡️ HARD-BLOCK FAIL-SAFE ATTIVO: # Nessun dato in chiaro può uscire verso il cloud in caso di errore.

[ { "word": "Mario Rossi", "label": "[PERSONA_1]", "entity": "private_person", "score": 0.998 }, { "word": "RSSMRA80A01H501U", "label": "[COD.FISCALE/P.IVA_1]", "entity": "cf_iva", "score": 1.0 }, { "word": "m.rossi@pec.comune.it", "label": "[EMAIL_1]", "entity": "private_email", "score": 1.0 } ]

Versione 0.51-alpha • 22 ottobre 2026

Novità della v0.51-alpha

Una versione di consolidamento con una Dashboard tutta nuova: motore riscritto in moduli, ogni correzione verificata da test ripetibili. Stessi modelli e stesso runtime della 0.50; l'elaborazione resta 100% offline.

Documenti Office intatti

Word, Excel, PowerPoint e OpenDocument vengono modificati direttamente nell'XML: grassetti, font, immagini, formule e macro restano identici. Anonimizzati anche note, commenti, caselle di testo, metadati e miniature.

PDF e scansioni più sicuri

OCR anche sulle scansioni con timbro di protocollo, pixel oscurati sotto il testo delle scansioni "ricercabili", pagine ruotate corrette; campi modulo, allegati e firme digitali PAdES non lasciano più passare dati.

Proxy per Claude Code e Codex

Streaming nei formati Anthropic e OpenAI Responses corretto, immagini e PDF allegati anonimizzati, argomenti dei tool sempre validi e cache che rende veloci le conversazioni lunghe.

Nuovi formati

RTF senza Microsoft Word, file firmati .p7m (es. fatture XML), JSON, TSV, Markdown, log e codice sorgente; i .doc che sono in realtà RTF o DOCX rinominati vengono riconosciuti da soli.

Riconoscimento più preciso

Il modello italiano legge i documenti lunghi per intero; IBAN europei, codici fiscali (anche letti male dall'OCR), carte, telefoni e targhe sono validati; un nome trovato una volta viene oscurato in tutto il documento.

Più affidabile e sicuro

Vault protetto, motore che si chiude con la finestra, avanzamento e motivo degli errori nella Dashboard, blocco delle impostazioni per la PA e API locale protetta dai siti esterni.

Nuova Dashboard per lavorare in blocco

Interfaccia più sobria e chiara: si aggiungono file o intere cartelle, i contatori mostrano i documenti in attesa, pronti e non riusciti e le cartelle di input e output si aprono con un clic. I file non elaborati sono elencati con il motivo e si rimettono in coda con un pulsante; l'elenco si esporta in CSV.

Endpoint per gli agenti AI

In Modalità Avanzata la scheda «Agenti AI e API» mostra gli indirizzi del Proxy e le istruzioni pronte da copiare per Claude Code, Codex CLI, Cursor, Antigravity, Windsurf, OpenCode, Continue, Aider e gli SDK OpenAI e Anthropic, con gli esempi delle API REST.

Aggiornamenti automatici

Solo se Windows segnala che il PC è connesso a Internet, Germano controlla su GitHub se esiste una nuova versione, la scarica da Google Drive, ne verifica l'impronta SHA-256 e la installa al riavvio. Documenti, Vault e impostazioni restano intatti; la funzione si disattiva dalla Dashboard.

Hai già la v0.50? Estrai la v0.51 in una nuova cartella e copia dalla vecchia extracted/deanonymize_vault.json (e, se vuoi, config.json): i documenti già protetti restano ripristinabili. Dalla v0.51 in poi Germano può aggiornarsi da solo. Elenco completo nel CHANGELOG.

Plug & Play • Windows 10/11 64-bit • 8 GB RAM (16 consigliati)

Provalo! (è completamente gratis e Open Source)

Nessun installer, nessuna configurazione. Estrai lo ZIP e fai doppio clic su START.bat: la Dashboard locale si apre nel browser.

1

Scarica ed estrai l'archivio ZIP Standalone

2

Copia i documenti in input/ e avvia START.bat

3

Clicca Avvia motore (oppure trascina i file: parte da solo) e apri i risultati con Apri cartella output

Download Versione Standalone v0.51 (~3 GB) Codice Sorgente su GitHub

Licenza GNU GPL v3

Germano AI è orgogliosamente distribuito sotto licenza GNU General Public License v3.0. Questo significa che sei libero di usare, studiare e condividere il software a costo zero, perfino per uso commerciale. L'unica regola è che se modifichi o distribuisci una versione derivata di Germano AI, devi renderla anch'essa Open Source rilasciandola sotto la stessa licenza GPL v3. Vogliamo che la privacy sia un diritto accessibile a tutti!

🤝 Collabora al Progetto!

Germano AI è un progetto guidato dalla community. Sei uno sviluppatore Python, un esperto legale o un appassionato di AI? Unisciti a noi! Fai un fork del repository su GitHub, apri una Pull Request e aiutaci a migliorare l'algoritmo, aggiungere nuovi formati supportati o ottimizzare l'interfaccia utente.