EuConform

🇪🇺 Kit de herramientas de evidencia de código abierto para el cumplimiento de la IA

Formato de evidencia abierto • Evaluación local de sesgos • Validación de esquemas • Interoperabilidad con CycloneDX
Offline-first • Preservación de la privacidad • Artefactos reutilizables • Accesible WCAG 2.2 AA

EuConform define un formato de evidencia abierto para el cumplimiento de la IA y proporciona las herramientas para producirlo, validarlo y evaluarlo empíricamente — sin conexión e independiente del proveedor.

[!IMPORTANT] Aviso legal: esta herramienta proporciona solo orientación técnica. No constituye asesoramiento legal y no reemplaza las evaluaciones de conformidad legalmente vinculantes de los organismos notificados ni la consulta legal profesional. Consulta siempre a profesionales legales cualificados para las decisiones de cumplimiento.

🚀 Inicio rápido · 📖 Documentación · 🌐 Desplegar · 🐛 Reportar un error

✨ Características

🧰 La CLI de un vistazo

🚀 Inicio rápido

¿Quieres probarlo sin instalación? Haz clic en el enlace 🌐 Desplegar de arriba para iniciar tu propia instancia en Vercel.

Requisitos previos

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

Instalación

# Clone the repository
git clone https://github.com/Hiepler/EuConform.git
cd EuConform

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Open http://localhost:3001

Compilar la CLI

Los ejemplos locales de este repositorio usan la CLI compilada directamente:

# Build the CLI
pnpm --filter @euconform/cli build

Flujo de trabajo 1: Escanear un repositorio

Genera artefactos nativos de EuConform a partir de un código base real:

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

Esto escribe:

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

Uso típico:

• recopilación de evidencia para proyectos OSS locales o proyectos internos de IA
• control de CI y traspaso a revisores
• generación de artefactos portables sin plataforma de proveedor

Para uso en CI, añade anotaciones nativas de GitHub y umbrales de fallo:

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

Para el intercambio de artefactos portables, crea un archivo bundle:

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

Flujo de trabajo 2: Validar y verificar artefactos existentes

Valida documentos JSON individuales de EuConform contra los esquemas publicados:

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

Salida típica:

• una línea por archivo, como euconform.aibom.json — valid (euconform.aibom.v1)
• código de salida 0 para entrada totalmente válida, 1 para errores de esquema, 2 cuando no se encuentran archivos JSON de EuConform

Verifica un manifiesto de bundle, un directorio de bundle extraído o un archivo ZIP:

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

Uso típico:

• comprobación de esquemas por parte del revisor antes del análisis manual
• comprobaciones de cordura en CI para conjuntos de artefactos ya producidos en otro lugar
• comprobaciones de portabilidad antes de compartir bundles con herramientas posteriores

Flujo de trabajo 3: Evaluar el sesgo del modelo localmente

Ejecuta una evaluación de sesgo CrowS-Pairs reproducible contra un modelo Ollama local:

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

Esta es la capa de evidencia empírica distintiva de EuConform. Produce datos de comportamiento del modelo que ninguna otra herramienta de cumplimiento de código abierto ofrece actualmente: completamente sin conexión, reproducible e independiente de cualquier API de proveedor.

Uso típico:

• evidencia empírica del comportamiento del modelo para la documentación de sesgo/equidad del Art. 10
• evaluación local reproducible antes y después de las actualizaciones del modelo
• adición de una capa de evidencia conductual sobre la evidencia estructural de scan

Flujo de trabajo 4: Importar un SBOM CycloneDX externo

Asigna un archivo JSON CycloneDX externo a la capa AI BOM de 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

Esto escribe:

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

Notas importantes:

• import acepta JSON CycloneDX y asigna solo el subconjunto relevante para IA a euconform.aibom.v1.1
• --scope production excluye los componentes optional y excluded
• el importador es intencionalmente conservador y no infiere capacidades de cumplimiento a partir de un SBOM
• el nombre del proyecto puede provenir de los metadatos del BOM o del nombre del archivo de origen, según la entrada

Prueba el formato en 10 minutos

Si quieres evaluar la ruta de adopción actual como desarrollador OSS, usa uno de los proyectos de referencia en examples/:

# 1. Build the CLI
pnpm --filter @euconform/cli build

# 2. Scan a reference project
node packages/cli/dist/index.js scan examples/ollama-chatbot \
  --scope production \
  --output /tmp/euconform-ollama

# 3. Verify the generated bundle
node packages/cli/dist/index.js verify /tmp/euconform-ollama/euconform.bundle.json

# 4. Open the web app and import the generated artifacts
pnpm dev

Para un ejemplo centrado en recuperación (retrieval-first), reemplaza examples/ollama-chatbot por examples/rag-assistant.

Uso con modelos de IA locales (opcional)

Para una detección de sesgo mejorada con tus propios modelos:

1. Instala Ollama: descárgalo desde ollama.ai
2. Descarga un modelo: ollama pull llama3.2
3. Inicia Ollama: ollama serve
4. Selecciona "Ollama" en la interfaz web

Compatible con variantes de Llama, Mistral y Qwen con detección automática de log-probabilidad.

[!WARNING] Implementación en Vercel / nube: esta función requiere ejecutar EuConform localmente (pnpm dev).

📖 Documentación

Fundamento legal y cobertura de cumplimiento

[!NOTE] Fuente legal principal: Reglamento (UE) 2024/1689 (Ley de IA de la UE)

Cobertura de la herramienta:

Cronograma de implementación: las obligaciones entran en vigor por etapas. Las obligaciones de alto riesgo se aplican a partir de 2027. Verifica siempre las directrices y los actos delegados vigentes.

Escáner CLI y CI

La CLI de EuConform está diseñada como infraestructura de evidencia reutilizable:

• euconform scan produce artefactos nativos de EuConform a partir de un repositorio.
• euconform bias proporciona la capa de evidencia empírica distintiva del comportamiento del modelo de EuConform.
• euconform validate comprueba archivos JSON individuales de EuConform contra los esquemas publicados.
• euconform verify comprueba la integridad de los conjuntos de artefactos de manifiestos, directorios y bundles ZIP.
• euconform import conecta JSON CycloneDX externos con la capa AI BOM de EuConform.

La aplicación web sigue siendo el lugar para la clasificación de roles y riesgos con contexto humano.

Ejemplo de 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

En GitHub Actions, EuConform emite:

• anotaciones de flujo de trabajo para las principales brechas de cumplimiento
• un resumen de paso en Markdown
• artefactos de CI legibles por máquina: euconform.ci.json y euconform.ci-summary.md

Formato de evidencia de EuConform

EuConform implementa el Formato de evidencia de EuConform, una especificación abierta para evidencia de cumplimiento de IA portable y legible por máquina.

• euconform.report.v1 captura evidencia de cumplimiento, brechas y preguntas abiertas
• euconform.aibom.v1 es la capa de inventario AI Bill of Materials (AI BOM)
• euconform.ci.v1 captura umbrales de CI, estado y principales hallazgos
• euconform.bundle.v1 agrupa conjuntos de artefactos en un manifiesto portable consciente de la integridad

Límites actuales del flujo de trabajo:

• scan produce artefactos nativos de EuConform a partir de repositorios fuente
• import puede ingestar JSON CycloneDX externos en la capa AIBOM actual para flujos de trabajo de interoperabilidad
• validate hace inspeccionable la historia de esquemas y compatibilidad a nivel de documento JSON
• verify comprueba la integridad del bundle portable antes del intercambio o la automatización

La documentación de la etapa 1, los esquemas y los artefactos de ejemplo se encuentran en docs/spec/README.md. Los proyectos fuente de referencia para desarrolladores OSS se encuentran en examples/README.md.

Metodología de prueba de sesgo

Usamos la metodología CrowS-Pairs (Nangia et al., 2020) para medir los sesgos sociales en los modelos de lenguaje.

Métodos de cálculo

[!TIP] Para obtener la mejor precisión, usa Ollama v0.1.26+ con modelos compatibles con el parámetro logprobs (Llama 3.2+, Mistral 7B+).

Declaración ética

Los pares de estereotipos se usan exclusivamente para evaluación científica y no reflejan las opiniones de los desarrolladores. Los pares individuales no se muestran en la interfaz para evitar reforzar estereotipos dañinos – solo se muestran métricas agregadas.

Conjuntos de pruebas personalizados

Crea pruebas de sesgo específicas de tu dominio subiendo tus propios casos de prueba:

[!TIP] Los conjuntos de pruebas personalizados se procesan íntegramente en tu navegador: tus casos de prueba propietarios nunca salen de tu 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"
}

🏗️ Estructura del proyecto

euconform/
├── apps/
│   ├── web/                  # Next.js 16 production app
│   └── docs/                 # Documentation site (WIP)
├── packages/
│   ├── cli/                  # Local repo scanner and CI integration
│   ├── core/                 # Risk engine, scanner engine, fairness metrics, types
│   ├── ui/                   # Shared UI components (shadcn-style)
│   ├── typescript-config/    # Shared TypeScript configuration
│   └── tailwind-config/      # Shared Tailwind configuration
├── .github/
│   ├── workflows/            # CI/CD pipelines
│   └── ISSUE_TEMPLATE/       # Issue templates
├── biome.json                # Biome linter config
└── turbo.json                # Turborepo pipeline config

🧪 Pruebas

# Run unit tests
pnpm test

# Run with coverage
pnpm test -- --coverage

# Run E2E tests (requires Playwright)
pnpm test:e2e

# Type checking
pnpm check-types

# Linting
pnpm lint

🛠️ Stack tecnológico

❓ Preguntas frecuentes

🤝 Contribuciones

¡Agradecemos las contribuciones! Lee primero nuestra Guía de contribución y nuestro Código de conducta.

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

# Install and develop
pnpm install
pnpm dev

# Before submitting
pnpm lint && pnpm check-types && pnpm test

Consulta CONTRIBUTING.md para obtener pautas detalladas.

🔒 Seguridad

Para problemas de seguridad, consulta nuestra Política de seguridad. No crees incidencias públicas para vulnerabilidades de seguridad.

📄 Licencia

Con doble licencia:

• Licencia MIT, para máxima compatibilidad
• EUPL-1.2, para compatibilidad con instituciones de la UE

Hecho con ❤️ para una IA responsable en Europa

Incidencias · Debates