EuConform

🇪🇺 Boîte à outils open source pour la conformité IA

Format de preuve ouvert • Évaluation locale des biais • Validation de schéma • Interopérabilité CycloneDX
Hors ligne en premier • Préservation de la vie privée • Artefacts réutilisables • Accessible WCAG 2.2 AA

EuConform définit un format de preuve ouvert pour la conformité IA et fournit les outils pour le produire, le valider et l'évaluer empiriquement — hors ligne et indépendant des fournisseurs.

[!IMPORTANT] Avertissement juridique : Cet outil fournit uniquement des conseils techniques. Il ne constitue pas un avis juridique et ne remplace pas les évaluations de conformité juridiquement contraignantes effectuées par des organismes notifiés ou une consultation juridique professionnelle. Consultez toujours des professionnels du droit qualifiés pour les décisions de conformité.

🚀 Démarrage rapide · 📖 Documentation · 🌐 Déployer · 🐛 Signaler un bug

✨ Fonctionnalités

🧰 CLI en un coup d'œil

🚀 Démarrage rapide

Vous voulez essayer sans installation ? Cliquez sur le lien 🌐 Déployer ci-dessus pour lancer votre propre instance sur Vercel.

Prérequis

• Node.js ≥ 18
• pnpm ≥ 10 (recommandé) ou npm/yarn

Installation

# Cloner le dépôt
git clone https://github.com/Hiepler/EuConform.git
cd EuConform

# Installer les dépendances
pnpm install

# Démarrer le serveur de développement
pnpm dev

# Ouvrir http://localhost:3001

Construire la CLI

Les exemples ci-dessous utilisent la CLI construite directement dans le dépôt :

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

Workflow 1 : Scanner un dépôt

Générer des artefacts EuConform natifs à partir d'un code source réel :

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

Cela écrit :

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

Usage typique :

• collecte de preuves pour des projets OSS locaux ou internes basés sur l'IA
• portes CI et transfert aux relecteurs
• génération d'artefacts portables sans plateforme fournisseur

Pour une utilisation CI, ajoutez des annotations GitHub natives et des seuils d'échec :

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

Pour un échange d'artefacts portable, créez une archive bundle :

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

Workflow 2 : Valider et vérifier des artefacts existants

Valider des documents JSON EuConform individuels par rapport aux schémas publiés :

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

Sortie typique :

• une ligne par fichier telle que euconform.aibom.json — valid (euconform.aibom.v1)
• code de sortie 0 pour une entrée entièrement valide, 1 pour des erreurs de schéma, 2 lorsqu'aucun fichier JSON EuConform n'est trouvé

Vérifier un manifeste de bundle, un répertoire de bundle extrait ou une archive ZIP :

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

Usage typique :

• vérification du schéma côté relecteur avant analyse manuelle
• contrôles de cohérence CI pour des ensembles d'artefacts déjà produits ailleurs
• vérifications de portabilité avant de partager des bundles avec des outils en aval

Workflow 3 : Évaluer les biais d'un modèle localement

Exécuter une évaluation de biais CrowS-Pairs reproductible contre un modèle Ollama local :

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

C'est la couche de preuve empirique distinctive d'EuConform. Elle produit des données de comportement de modèle qu'aucun autre outil de conformité open source ne propose actuellement — entièrement hors ligne, reproductible et indépendant de toute API de fournisseur.

Usage typique :

• preuve empirique de comportement de modèle pour la documentation des biais/équité de l'Art. 10
• évaluation locale reproductible avant et après les mises à jour du modèle
• ajout d'une couche de preuve comportementale au-dessus de la preuve structurelle issue de scan

Workflow 4 : Importer un SBOM CycloneDX externe

Mapper un fichier CycloneDX JSON externe dans la couche AI BOM d'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

Cela écrit :

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

Remarques importantes :

• import accepte le JSON CycloneDX et ne mappe que le sous-ensemble pertinent pour l'IA dans euconform.aibom.v1.1
• --scope production exclut les composants optional et excluded
• l'importateur est intentionnellement conservateur et n'infère pas de capacités de conformité à partir d'un SBOM
• le nommage du projet peut provenir des métadonnées du BOM ou du nom du fichier source, selon l'entrée

Essayer le format en 10 minutes

Si vous souhaitez évaluer le parcours d'adoption actuel en tant que constructeur OSS, utilisez l'un des projets de référence dans examples/ :

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

# 2. Scanner un projet de référence
node packages/cli/dist/index.js scan examples/ollama-chatbot \
  --scope production \
  --output /tmp/euconform-ollama

# 3. Vérifier le bundle généré
node packages/cli/dist/index.js verify /tmp/euconform-ollama/euconform.bundle.json

# 4. Ouvrir l'application web et importer les artefacts générés
pnpm dev

Pour un exemple orienté récupération, remplacez examples/ollama-chatbot par examples/rag-assistant.

Utilisation avec des modèles IA locaux (optionnel)

Pour une détection améliorée des biais avec vos propres modèles :

1. Installer Ollama : Télécharger depuis ollama.ai
2. Tirer un modèle : ollama pull llama3.2
3. Démarrer Ollama : ollama serve
4. Sélectionner "Ollama" dans l'interface web

Prend en charge les variantes Llama, Mistral et Qwen avec détection automatique de la log-probabilité.

[!WARNING] Vercel / Déploiement cloud : Cette fonctionnalité nécessite d'exécuter EuConform localement (pnpm dev).

📖 Documentation

Fondement juridique et couverture de conformité

[!NOTE] Source juridique principale : Règlement (UE) 2024/1689 (EU AI Act)

Couverture de l'outil :

Calendrier de mise en œuvre : Les obligations entrent en vigueur par étapes. Les obligations à haut risque s'appliquent à partir de 2027. Vérifiez toujours les lignes directrices et les actes délégués en vigueur.

Scanner CLI et CI

La CLI d'EuConform est conçue comme une infrastructure de preuve réutilisable :

• euconform scan produit des artefacts EuConform natifs à partir d'un dépôt.
• euconform bias fournit la couche de preuve empirique distinctive du comportement du modèle d'EuConform.
• euconform validate vérifie les fichiers JSON EuConform individuels par rapport aux schémas publiés.
• euconform verify vérifie l'intégrité des ensembles d'artefacts pour les manifestes, répertoires et bundles ZIP.
• euconform import fait le pont entre les JSON CycloneDX externes et la couche AI BOM d'EuConform.

L'application web reste l'endroit pour la classification des rôles et des risques avec un contexte humain.

Exemple GitHub Actions

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

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

Dans GitHub Actions, EuConform émet :

• annotations de workflow pour les principales lacunes de conformité
• un résumé d'étape au format markdown
• artefacts CI lisibles par machine : euconform.ci.json et euconform.ci-summary.md

Format de preuve EuConform

EuConform implémente le format de preuve EuConform, une spécification ouverte pour des preuves de conformité IA portables et lisibles par machine.

• euconform.report.v1 capture les preuves de conformité, les lacunes et les questions ouvertes
• euconform.aibom.v1 est la couche d'inventaire du Bill of Materials IA (AI BOM)
• euconform.ci.v1 capture les seuils CI, l'état et les principales constatations
• euconform.bundle.v1 lie les ensembles d'artefacts dans un manifeste portable et sensible à l'intégrité

Limites actuelles du workflow :

• scan produit des artefacts EuConform natifs à partir des dépôts sources
• import peut ingérer du JSON CycloneDX externe dans la couche AIBOM actuelle pour les workflows d'interopérabilité
• validate rend le schéma et l'histoire de compatibilité inspectables au niveau du document JSON
• verify vérifie l'intégrité du bundle portable avant échange ou automatisation

La documentation de l'étape 1, les schémas et les exemples d'artefacts se trouvent dans docs/spec/README.md. Les projets sources de référence pour les constructeurs OSS se trouvent dans examples/README.md.

Méthodologie de test des biais

Nous utilisons la méthodologie CrowS-Pairs (Nangia et al., 2020) pour mesurer les biais sociaux dans les modèles de langage.

Méthodes de calcul

[!TIP] Pour une meilleure précision, utilisez Ollama v0.1.26+ avec des modèles prenant en charge le paramètre logprobs (Llama 3.2+, Mistral 7B+).

Déclaration éthique

Les paires de stéréotypes sont utilisées uniquement pour l'évaluation scientifique et ne reflètent pas les opinions des développeurs. Les paires individuelles ne sont pas affichées dans l'interface utilisateur pour éviter de renforcer des stéréotypes nuisibles – seules les métriques agrégées sont présentées.

Suites de test personnalisées

Créez des tests de biais spécifiques à un domaine en téléchargeant vos propres cas de test :

[!TIP] Les suites de test personnalisées sont traitées entièrement dans votre navigateur – vos cas de test propriétaires ne quittent jamais votre appareil.

@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"
}

🏗️ Structure du projet

euconform/
├── apps/
│   ├── web/                  # Application de production Next.js 16
│   └── docs/                 # Site de documentation (en cours)
├── packages/
│   ├── cli/                  # Scanner de dépôt local et intégration CI
│   ├── core/                 # Moteur de risque, moteur de scan, métriques d'équité, types
│   ├── ui/                   # Composants d'interface partagés (style shadcn)
│   ├── typescript-config/    # Configuration TypeScript partagée
│   └── tailwind-config/      # Configuration Tailwind partagée
├── .github/
│   ├── workflows/            # Pipelines CI/CD
│   └── ISSUE_TEMPLATE/       # Modèles d'issues
├── biome.json                # Config du linter Biome
└── turbo.json                # Configuration du pipeline Turborepo

🧪 Tests

# Exécuter les tests unitaires
pnpm test

# Exécuter avec couverture
pnpm test -- --coverage

# Exécuter les tests E2E (nécessite Playwright)
pnpm test:e2e

# Vérification des types
pnpm check-types

# Linting
pnpm lint

🛠️ Stack technique

❓ FAQ

🤝 Contribuer

Nous accueillons les contributions ! Veuillez d'abord lire notre Guide de contribution et notre Code de conduite.

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

# Installer et développer
pnpm install
pnpm dev

# Avant de soumettre
pnpm lint && pnpm check-types && pnpm test

Voir CONTRIBUTING.md pour des directives détaillées.

🔒 Sécurité

Pour les préoccupations de sécurité, veuillez consulter notre Politique de sécurité. Ne pas créer d'issues publiques pour les vulnérabilités de sécurité.

📄 Licence

Sous double licence :

• Licence MIT – pour une compatibilité maximale
• EUPL-1.2 – pour la compatibilité avec les institutions européennes

Fait avec ❤️ pour une IA responsable en Europe

Issues · Discussions