EuConform

🇪🇺 Toolkit di Evidenze Open-Source per la Conformità AI

Formato di evidenze aperto • Valutazione locale dei bias • Validazione dello schema • Interoperabilità CycloneDX
Prima offline • Privacy-preservante • Artefatti riutilizzabili • Accessibile WCAG 2.2 AA

EuConform definisce un formato di evidenze aperto per la conformità AI e fornisce gli strumenti per produrlo, validarlo e valutarlo empiricamente — offline e indipendente dal fornitore.

---

[!IMPORTANT] Disclaimer Legale: Questo strumento fornisce solo indicazioni tecniche. Non costituisce consulenza legale e non sostituisce le valutazioni di conformità giuridicamente vincolanti da parte di organismi notificati o la consulenza legale professionale. Consulta sempre professionisti legali qualificati per le decisioni di conformità.

---

🚀 Avvio Rapido · 📖 Documentazione · 🌐 Distribuisci · 🐛 Segnala Bug

---

✨ Funzionalità

Caratteristica	Descrizione
🧾 Formato di Evidenze Aperto	Produce artefatti portatili report, aibom, ci e bundle come documenti JSON ispezionabili
🧪 Valutazione Locale dei Bias	Valutazione dei modelli basata su CrowS-Pairs con fallback su log-probabilità e latenza — riproducibile, offline, senza dipendenza dal fornitore
✅ Validazione dello Schema	Valida i documenti JSON di EuConform rispetto agli schemi pubblicati con euconform validate
📦 Verifica del Bundle	Verifica l'integrità del manifest, della directory o del bundle ZIP prima di consegnare gli artefatti a CI, revisori o auditor
🚦 Gate CI di Conformità	Trasforma euconform scan in annotazioni native di GitHub, riepiloghi CI e artefatti leggibili dalla macchina
🎯 Classificazione del Rischio	Quiz interattivo che implementa l'articolo 5 (pratiche vietate), l'articolo 6 + Allegato III (alto rischio) dell'AI Act UE
🔄 Interoperabilità CycloneDX	Importa SBOM CycloneDX esterni nel layer AI BOM di EuConform come ponte di interoperabilità
🌐 Prima Offline	I flussi di lavoro principali delle evidenze rimangono locali e ispezionabili invece di dipendere da dashboard dei fornitori
🔒 Privacy-Preservante	Zero tracciamento, nessun cookie, nessun font esterno – i tuoi dati rimangono sotto il tuo controllo
🌙 Modalità Scura	Splendido design vetroso con pieno supporto della modalità scura
♿ Accessibile	Conforme a WCAG 2.2 AA con navigazione completa da tastiera
🌍 Multilingua	Interfaccia in inglese e tedesco

🧰 CLI in Breve

Comando	Output primario	Caso d'uso
scan	Artefatti nativi EuConform	Genera evidenze strutturate da un repository reale
bias	Report bias JSON e/o Markdown	Esegue una valutazione locale riproducibile del modello con Ollama — il caratteristico layer empirico di EuConform
validate	Stato valido/non valido per file JSON	Controlla i file JSON di EuConform rispetto agli schemi pubblicati
verify	Stato di integrità del bundle	Controlla un manifest, un bundle estratto o un archivio ZIP
import	euconform.aibom.json	Mappa un SBOM CycloneDX esterno nel layer AI BOM di EuConform

🚀 Avvio Rapido

Vuoi provarlo senza installazione? Clicca sul link 🌐 Distribuisci sopra per avviare la tua istanza su Vercel.

Prerequisiti

• Node.js ≥ 18
• pnpm ≥ 10 (consigliato) o npm/yarn

Installazione

# Clona il repository
git clone https://github.com/Hiepler/EuConform.git
cd EuConform

# Installa le dipendenze
pnpm install

# Avvia il server di sviluppo
pnpm dev

# Apri http://localhost:3001

Compila la CLI

Gli esempi seguenti usano direttamente la CLI compilata nel repository locale:

# Compila la CLI
pnpm --filter @euconform/cli build

Flusso di Lavoro 1: Analizza un Repository

Genera artefatti nativi EuConform da un codebase reale:

node packages/cli/dist/index.js scan . --scope production

Questo scrive:

• .euconform/euconform.report.json
• .euconform/euconform.aibom.json
• .euconform/euconform.summary.md
• .euconform/euconform.bundle.json

Utilizzo tipico:

• raccolta di evidenze per progetti OSS locali o AI interni
• gating CI e passaggio di consegne ai revisori
• generazione di artefatti portatili senza una piattaforma fornitore

Per l'uso in CI, aggiungi annotazioni native di GitHub e soglie di fallimento:

node packages/cli/dist/index.js scan . --scope production --ci github --fail-on high

Per lo scambio di artefatti portatili, crea un archivio bundle:

node packages/cli/dist/index.js scan . --scope production --zip true

Flusso di Lavoro 2: Valida e Verifica Artefatti Esistenti

Valida singoli documenti JSON di EuConform rispetto agli schemi pubblicati:

node packages/cli/dist/index.js validate .euconform

Output tipico:

• una riga per file come euconform.aibom.json — valido (euconform.aibom.v1)
• codice di uscita 0 per input completamente valido, 1 per errori di schema, 2 quando non vengono trovati file JSON di EuConform

Verifica un manifest di bundle, una directory di bundle estratta o un archivio ZIP:

node packages/cli/dist/index.js verify .euconform/euconform.bundle.json

Utilizzo tipico:

• controllo dello schema lato revisore prima dell'analisi manuale
• controlli di integrità CI per set di artefatti già prodotti altrove
• controlli di portabilità prima di condividere i bundle con strumenti a valle

Flusso di Lavoro 3: Valuta i Bias del Modello Localmente

Esegui una valutazione riproducibile dei bias CrowS-Pairs su un modello Ollama locale:

node packages/cli/dist/index.js bias llama3.2 --lang de --output all