EuConform

🇪🇺 Kit de Ferramentas de Evidências de Código Aberto para Conformidade com IA

Formato de evidência aberto • Avaliação local de viés • Validação de schema • Interoperabilidade com CycloneDX
Offline-first • Preservação de privacidade • Artefatos reutilizáveis • Acessível WCAG 2.2 AA

O EuConform define um formato de evidência aberto para conformidade com IA e fornece as ferramentas para produzir, validar e avaliar empiricamente esse formato — offline e independente de fornecedores.

[!IMPORTANT] Aviso Legal: Esta ferramenta fornece apenas orientação técnica. Ela não constitui aconselhamento jurídico e não substitui avaliações de conformidade juridicamente vinculativas realizadas por organismos notificados ou consultoria jurídica profissional. Consulte sempre profissionais de direito qualificados para decisões de conformidade.

🚀 Início Rápido · 📖 Documentação · 🌐 Implantar · 🐛 Reportar Bug

✨ Funcionalidades

🧰 CLI Em Resumo

🚀 Início Rápido

Quer experimentar sem instalar? Clique no link 🌐 Implantar acima para iniciar sua própria instância na Vercel.

Pré-requisitos

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

Instalação

# 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 a CLI

Os exemplos locais abaixo usam a CLI compilada diretamente:

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

Fluxo de Trabalho 1: Escanear um Repositório

Gere artefatos nativos do EuConform a partir de um código-fonte real:

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

Isso grava:

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

Uso típico:

• coleta de evidências para projetos locais de OSS ou IA interna
• gate de CI e transição para revisores
• geração de artefatos portáteis sem plataforma de fornecedor

Para uso em CI, adicione anotações nativas do GitHub e limites de falha:

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

Para intercâmbio de artefatos portáteis, crie um arquivo de bundle:

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

Fluxo de Trabalho 2: Validar e Verificar Artefatos Existentes

Valide documentos JSON individuais do EuConform contra os schemas publicados:

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

Saída típica:

• uma linha por arquivo, como euconform.aibom.json — válido (euconform.aibom.v1)
• código de saída 0 para entrada totalmente válida, 1 para erros de schema, 2 quando nenhum arquivo JSON do EuConform é encontrado

Verifique um manifesto de bundle, diretório de bundle extraído ou arquivo ZIP:

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

Uso típico:

• verificação de schema no lado do revisor antes da análise manual
• verificações de sanidade na CI para conjuntos de artefatos já produzidos em outro lugar
• verificações de portabilidade antes de compartilhar bundles com ferramentas downstream

Fluxo de Trabalho 3: Avaliar Viés de Modelo Localmente

Execute uma avaliação reproduzível de viés CrowS-Pairs contra um modelo Ollama local:

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

Esta é a camada de evidência empírica distinta do EuConform. Ela produz dados de comportamento do modelo que nenhuma outra ferramenta de conformidade de código aberto oferece atualmente — completamente offline, reproduzível e independente de qualquer API de fornecedor.

Uso típico:

• evidência empírica de comportamento do modelo para a documentação de viés/justiça do Art. 10
• avaliação local reproduzível antes e depois de atualizações do modelo
• adição de uma camada de evidência comportamental sobre a evidência estrutural do scan

Fluxo de Trabalho 4: Importar um SBOM CycloneDX Externo

Mapeie um arquivo JSON CycloneDX externo para a camada de AI BOM do 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

Isso grava:

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

Notas importantes:

• import aceita JSON CycloneDX e mapeia apenas o subconjunto relevante para IA em euconform.aibom.v1.1
• --scope production exclui componentes optional e excluded
• o importador é intencionalmente conservador e não infere capacidades de conformidade a partir de um SBOM
• a nomeação do projeto pode vir dos metadados do BOM ou do nome do arquivo de origem, dependendo da entrada

Experimente o Formato em 10 Minutos

Se você quiser avaliar o caminho atual de adoção como desenvolvedor de OSS, use um dos projetos de referência em 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 um exemplo focado em recuperação (retrieval-first), substitua examples/ollama-chatbot por examples/rag-assistant.

Uso com Modelos de IA Locais (Opcional)

Para detecção de viés aprimorada com seus próprios modelos:

1. Instale o Ollama: Baixe de ollama.ai
2. Baixe um modelo: ollama pull llama3.2
3. Inicie o Ollama: ollama serve
4. Selecione "Ollama" na interface web

Suporta variantes Llama, Mistral e Qwen com detecção automática de log-probabilidade.

[!WARNING] Implantação na Vercel / Nuvem: Este recurso exige executar o EuConform localmente (pnpm dev).

📖 Documentação

Fundamento Legal e Cobertura de Conformidade

[!NOTE] Fonte Jurídica Primária: Regulamento (UE) 2024/1689 (EU AI Act)

Cobertura da Ferramenta:

Cronograma de Implementação: As obrigações entram em vigor em etapas. As obrigações de alto risco passam a valer a partir de 2027. Sempre verifique as diretrizes atuais e os atos delegados.

Scanner da CLI e CI

A CLI do EuConform foi projetada como infraestrutura de evidência reutilizável:

• euconform scan produz artefatos nativos do EuConform a partir de um repositório.
• euconform bias fornece a camada distinta de evidência empírica de comportamento do modelo do EuConform.
• euconform validate verifica arquivos JSON individuais do EuConform contra os schemas publicados.
• euconform verify verifica a integridade de conjuntos de artefatos para manifestos, diretórios e bundles ZIP.
• euconform import faz a ponte entre JSON CycloneDX externo e a camada de AI BOM do EuConform.

O aplicativo web continua sendo o local para classificação de papéis e riscos com contexto humano.

Exemplo 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

No GitHub Actions, o EuConform emite:

• anotações de workflow para as principais lacunas de conformidade
• um resumo de etapa em markdown
• artefatos de CI legíveis por máquina: euconform.ci.json e euconform.ci-summary.md

Formato de Evidência EuConform

O EuConform implementa o Formato de Evidência EuConform, uma especificação aberta para evidências de conformidade de IA portáteis e legíveis por máquina.

• euconform.report.v1 captura evidências de conformidade, lacunas e perguntas em aberto
• euconform.aibom.v1 é a camada de inventário do AI Bill of Materials (AI BOM)
• euconform.ci.v1 captura limites, status e principais achados de CI
• euconform.bundle.v1 agrupa conjuntos de artefatos em um manifesto portátil e ciente de integridade

Limites atuais do fluxo de trabalho:

• scan produz artefatos nativos do EuConform a partir de repositórios de código-fonte
• import pode ingerir JSON CycloneDX externo na camada AIBOM atual para fluxos de interoperabilidade
• validate torna a história de schema e compatibilidade inspecionável no nível do documento JSON
• verify verifica a integridade do bundle portátil antes da troca ou automação

A documentação, os schemas e os artefatos de exemplo do Estágio 1 estão em docs/spec/README.md. Projetos-fonte de referência para desenvolvedores de OSS estão em examples/README.md.

Metodologia de Teste de Viés

Utilizamos a metodologia CrowS-Pairs (Nangia et al., 2020) para medir vieses sociais em modelos de linguagem.

Métodos de Cálculo

[!TIP] Para melhor precisão, use Ollama v0.1.26+ com modelos que suportam o parâmetro logprobs (Llama 3.2+, Mistral 7B+).

Declaração de Ética

Os pares de estereótipos são usados exclusivamente para avaliação científica e não refletem as opiniões dos desenvolvedores. Pares individuais não são exibidos na interface para evitar o reforço de estereótipos prejudiciais — apenas métricas agregadas são mostradas.

Suítes de Teste Personalizadas

Crie testes de viés específicos de domínio enviando seus próprios casos de teste:

[!TIP] As suítes de teste personalizadas são processadas inteiramente no seu navegador — seus casos de teste proprietários nunca saem do seu 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"
}

🏗️ Estrutura do Projeto

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

🧪 Testes

# 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ógica

❓ FAQ

🤝 Contribuindo

Aceitamos contribuições! Por favor, leia nosso Guia de Contribuição e nosso Código de Conduta primeiro.

# 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

Consulte CONTRIBUTING.md para diretrizes detalhadas.

🔒 Segurança

Para preocupações de segurança, consulte nossa Política de Segurança. Não crie issues públicas para vulnerabilidades de segurança.

📄 Licença

Dupla licença:

• Licença MIT – para máxima compatibilidade
• EUPL-1.2 – para compatibilidade com instituições da UE

Feito com ❤️ para uma IA responsável na Europa

Issues · Discussões