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à

🧰 CLI in Breve

🚀 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

Questo è il caratteristico layer di evidenza empirica di EuConform. Produce dati sul comportamento del modello che nessun altro strumento di conformità open-source offre attualmente — completamente offline, riproducibile e indipendente da qualsiasi API fornitore.

Utilizzo tipico:

• evidenza empirica del comportamento del modello per la documentazione su bias/equità dell'Art. 10
• valutazione locale riproducibile prima e dopo gli aggiornamenti del modello
• aggiunta di un layer di evidenza comportamentale sopra le evidenze strutturali di scan

Flusso di Lavoro 4: Importa un SBOM CycloneDX Esterno

Mappa un file CycloneDX JSON esterno nel layer AI BOM di EuConform:

node packages/cli/dist/index.js import ./third-party.cdx.json \
  --scope production \
  --output /tmp/euconform-import

node packages/cli/dist/index.js validate /tmp/euconform-import/euconform.aibom.json

Questo scrive:

• /tmp/euconform-import/euconform.aibom.json

Note importanti:

• import accetta CycloneDX JSON e mappa solo il sottoinsieme rilevante per l'AI in euconform.aibom.v1.1
• --scope production esclude i componenti optional ed excluded
• l'importatore è intenzionalmente conservativo e non deduce capacità di conformità da un SBOM
• la denominazione del progetto può provenire dai metadati BOM o dal nome del file sorgente, a seconda dell'input

Prova il Formato in 10 Minuti

Se vuoi valutare il percorso di adozione corrente come costruttore OSS, usa uno dei progetti di riferimento in examples/:

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

# 2. Analizza un progetto di riferimento
node packages/cli/dist/index.js scan examples/ollama-chatbot \
  --scope production \
  --output /tmp/euconform-ollama

# 3. Verifica il bundle generato
node packages/cli/dist/index.js verify /tmp/euconform-ollama/euconform.bundle.json

# 4. Apri l'app web e importa gli artefatti generati
pnpm dev

Per un esempio incentrato sul recupero, sostituisci examples/ollama-chatbot con examples/rag-assistant.

Utilizzo con Modelli AI Locali (Opzionale)

Per un rilevamento avanzato dei bias con i tuoi modelli:

1. Installa Ollama: Scarica da ollama.ai
2. Scarica un modello: ollama pull llama3.2
3. Avvia Ollama: ollama serve
4. Seleziona "Ollama" nell'interfaccia web

Supporta le varianti Llama, Mistral e Qwen con rilevamento automatico della log-probabilità.

[!WARNING] Vercel / Distribuzione Cloud: Questa funzionalità richiede l'esecuzione di EuConform localmente (pnpm dev).

📖 Documentazione

Fondamento Giuridico e Copertura di Conformità

[!NOTE] Fonte Legale Primaria: Regolamento (UE) 2024/1689 (AI Act UE)

Copertura dello Strumento:

Cronologia di Implementazione: Gli obblighi diventano effettivi a fasi. Gli obblighi ad alto rischio si applicano dal 2027. Verifica sempre le linee guida e gli atti delegati correnti.

Scanner CLI e CI

La CLI di EuConform è progettata come infrastruttura di evidenze riutilizzabile:

• euconform scan produce artefatti nativi EuConform da un repository.
• euconform bias fornisce il caratteristico layer di evidenza empirica del comportamento del modello di EuConform.
• euconform validate controlla singoli file JSON di EuConform rispetto agli schemi pubblicati.
• euconform verify controlla l'integrità del set di artefatti per manifest, directory e bundle ZIP.
• euconform import collega CycloneDX JSON esterno nel layer AI BOM di EuConform.

L'app web rimane il posto per la classificazione di ruolo e rischio con contesto umano.

Esempio GitHub Actions

- name: Compila CLI
  run: pnpm --filter @euconform/cli build

- name: Esegui scansione EuConform
  run: node packages/cli/dist/index.js scan . --scope production --ci github --fail-on high

In GitHub Actions, EuConform emette:

• annotazioni del flusso di lavoro per le principali lacune di conformità
• un riepilogo del passaggio in markdown
• artefatti CI leggibili dalla macchina: euconform.ci.json e euconform.ci-summary.md

Formato di Evidenze EuConform

EuConform implementa il Formato di Evidenze EuConform, una specifica aperta per evidenze di conformità AI portatili e leggibili dalla macchina.

• euconform.report.v1 cattura evidenze, lacune e domande aperte sulla conformità
• euconform.aibom.v1 è il layer di inventario dell'AI Bill of Materials (AI BOM)
• euconform.ci.v1 cattura soglie CI, stato e risultati principali
• euconform.bundle.v1 lega set di artefatti in un manifest portatile e attento all'integrità

Confini attuali del flusso di lavoro:

• scan produce artefatti nativi EuConform dai repository sorgente
• import può ingerire CycloneDX JSON esterno nell'attuale layer AIBOM per flussi di lavoro di interoperabilità
• validate rende ispezionabili a livello di documento JSON la storia dello schema e della compatibilità
• verify controlla l'integrità del bundle portatile prima dello scambio o dell'automazione

La documentazione di Fase 1, gli schemi e gli artefatti di esempio si trovano in docs/spec/README.md. I progetti sorgente di riferimento per costruttori OSS si trovano in examples/README.md.

Metodologia di Test dei Bias

Usiamo la metodologia CrowS-Pairs (Nangia et al., 2020) per misurare i bias sociali nei modelli linguistici.

Metodi di Calcolo

[!TIP] Per la massima precisione, usa Ollama v0.1.26+ con modelli che supportano il parametro logprobs (Llama 3.2+, Mistral 7B+).

Dichiarazione Etica

Le coppie di stereotipi sono utilizzate esclusivamente per la valutazione scientifica e non riflettono le opinioni degli sviluppatori. Le coppie individuali non vengono visualizzate nell'interfaccia per evitare di rafforzare stereotipi dannosi – vengono mostrate solo metriche aggregate.

Suite di Test Personalizzate

Crea test di bias specifici per dominio caricando i tuoi casi di test:

[!TIP] Le suite di test personalizzate vengono elaborate interamente nel tuo browser – i tuoi casi di test proprietari non lasciano mai il tuo dispositivo.

@inproceedings{nangia-etal-2020-crows,
    title = "{C}row{S}-Pairs: A Challenge Dataset for Measuring Social Biases in Masked Language Models",
    author = "Nangia, Nikita and Vania, Clara and Bhalerao, Rasika and Bowman, Samuel R.",
    booktitle = "Proceedings of the 2020 Conference on Empirical Methods in Natural Language Processing (EMNLP)",
    year = "2020",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2020.emnlp-main.154",
    doi = "10.18653/v1/2020.emnlp-main.154",
    pages = "1953--1967"
}

🏗️ Struttura del Progetto

euconform/
├── apps/
│   ├── web/                  # App di produzione Next.js 16
│   └── docs/                 # Sito di documentazione (WIP)
├── packages/
│   ├── cli/                  # Scanner locale del repository e integrazione CI
│   ├── core/                 # Motore di rischio, motore di scansione, metriche di equità, tipi
│   ├── ui/                   # Componenti UI condivisi (stile shadcn)
│   ├── typescript-config/    # Configurazione TypeScript condivisa
│   └── tailwind-config/      # Configurazione Tailwind condivisa
├── .github/
│   ├── workflows/            # Pipeline CI/CD
│   └── ISSUE_TEMPLATE/       # Template per issue
├── biome.json                # Configurazione linter Biome
└── turbo.json                # Configurazione pipeline Turborepo

🧪 Test

# Esegui test unitari
pnpm test

# Esegui con copertura
pnpm test -- --coverage

# Esegui test E2E (richiede Playwright)
pnpm test:e2e

# Controllo dei tipi
pnpm check-types

# Linting
pnpm lint

🛠️ Stack Tecnologico

❓ FAQ

🤝 Contribuire

Accogliamo con favore i contributi! Leggi prima la nostra Guida al Contributo e il Codice di Condotta.

# Fork e clona
git clone https://github.com/yourusername/EuConform.git
cd EuConform

# Installa e sviluppa
pnpm install
pnpm dev

# Prima di inviare
pnpm lint && pnpm check-types && pnpm test

Vedi CONTRIBUTING.md per linee guida dettagliate.

🔒 Sicurezza

Per questioni di sicurezza, consulta la nostra Politica di Sicurezza. Non creare issue pubbliche per vulnerabilità di sicurezza.

📄 Licenza

Doppia licenza sotto:

• Licenza MIT – per la massima compatibilità
• EUPL-1.2 – per la compatibilità con le istituzioni UE

Realizzato con ❤️ per un'IA responsabile in Europa

Issue · Discussioni