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

Funcionalidade	Descrição
🧾 Formato de Evidência Aberto	Produz artefatos portáteis report, aibom, ci e bundle como documentos JSON inspecionáveis
🧪 Avaliação Local de Viés	Avaliação de modelos baseada em CrowS-Pairs com fallback de log-probabilidade e latência — reproduzível, offline e sem dependência de fornecedores
✅ Validação de Schema	Valida documentos JSON do EuConform contra os schemas publicados com euconform validate
📦 Verificação de Bundle	Verifica a integridade de manifestos, diretórios ou bundles ZIP antes de entregar artefatos a CI, revisores ou auditores
🚦 Gate de CI para Conformidade	Transforma euconform scan em anotações nativas do GitHub, resumos de CI e artefatos legíveis por máquina
🎯 Classificação de Risco	Questionário interativo que implementa o Artigo 5 (sistemas proibidos) e o Artigo 6 + Anexo III (alto risco) do EU AI Act
🔄 Interoperabilidade com CycloneDX	Importa SBOMs CycloneDX externos para a camada de AI BOM do EuConform como ponte de interoperabilidade
🌐 Offline-First	Os fluxos de trabalho principais de evidências permanecem locais e inspecionáveis, em vez de depender de dashboards de fornecedores
🔒 Preservação de Privacidade	Zero rastreamento, sem cookies, sem fontes externas — seus dados permanecem sob seu controle
🌙 Modo Escuro	Design de glassmorphism elegante com suporte completo a modo escuro
♿ Acessível	Compatível com WCAG 2.2 AA e navegação completa por teclado
🌍 Multilíngue	Interface em inglês e alemão

🧰 CLI Em Resumo

Comando	Saída principal	Caso de uso
scan	Artefatos nativos do EuConform	Gerar evidências estruturadas a partir de um repositório real
bias	Relatório de viés JSON e/ou Markdown	Executar avaliação local reproduzível de modelos com Ollama — a camada empírica distinta do EuConform
validate	Status válido/inválido por arquivo JSON	Verificar arquivos JSON do EuConform contra os schemas publicados
verify	Status de integridade do bundle	Verificar um manifesto, bundle extraído ou arquivo ZIP
import	euconform.aibom.json	Mapear um SBOM CycloneDX externo para a camada de AI BOM do EuConform

🚀 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