EuConform

🇪🇺 Набор инструментов с открытым исходным кодом для доказательств соответствия ИИ

Открытый формат доказательств • Локальная оценка предвзятости • Проверка схем • Интероперабельность CycloneDX
Приоритет офлайн • Конфиденциальность • Повторно используемые артефакты • Доступность WCAG 2.2 AA

EuConform определяет открытый формат доказательств для соответствия требованиям ИИ и предоставляет инструменты для создания, проверки и эмпирической оценки этих доказательств — офлайн и независимо от поставщика.

[!IMPORTANT] Юридическое предупреждение: Этот инструмент предоставляет только технические рекомендации. Он не является юридической консультацией и не заменяет юридически обязательные оценки соответствия уполномоченными органами или профессиональную юридическую консультацию. Всегда обращайтесь к квалифицированным юристам для принятия решений о соответствии.

🚀 Быстрый старт · 📖 Документация · 🌐 Развернуть · 🐛 Сообщить об ошибке

✨ Возможности

🧰 CLI вкратце

🚀 Быстрый старт

Хотите попробовать без установки? Нажмите на ссылку 🌐 Развернуть выше, чтобы запустить собственный экземпляр на Vercel.

Предварительные требования

• Node.js ≥ 18
• pnpm ≥ 10 (рекомендуется) или npm/yarn

Установка

# Клонировать репозиторий
git clone https://github.com/Hiepler/EuConform.git
cd EuConform

# Установить зависимости
pnpm install

# Запустить сервер разработки
pnpm dev

# Открыть http://localhost:3001

Сборка CLI

Примеры ниже используют собранный CLI напрямую:

# Собрать CLI
pnpm --filter @euconform/cli build

Рабочий процесс 1: Сканирование репозитория

Создание нативных артефактов EuConform из реальной кодовой базы:

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

Будут созданы:

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

Типичное использование:

• сбор доказательств для локальных проектов OSS или внутренних ИИ-проектов
• CI-шлюзы и передача рецензентам
• создание портативных артефактов без платформы поставщика

Для использования в CI с аннотациями GitHub и порогами ошибок:

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

Для портативного обмена артефактами создайте архив пакета:

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

Рабочий процесс 2: Проверка и верификация существующих артефактов

Проверка отдельных JSON-документов EuConform на соответствие опубликованным схемам:

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

Типичный вывод:

• одна строка на файл, например euconform.aibom.json — valid (euconform.aibom.v1)
• код выхода 0 для полностью валидного ввода, 1 при ошибках схемы, 2 если JSON-файлы EuConform не найдены

Верификация манифеста пакета, извлечённой директории пакета или ZIP-архива:

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

Типичное использование:

• проверка схемы на стороне рецензента перед ручным анализом
• санитарные проверки CI для наборов артефактов, уже созданных в другом месте
• проверки портативности перед передачей пакетов downstream-инструментам

Рабочий процесс 3: Локальная оценка предвзятости модели

Запуск воспроизводимой оценки предвзятости CrowS-Pairs для локальной модели Ollama:

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

Это отличительный эмпирический слой доказательств EuConform. Он генерирует данные о поведении модели, которые в настоящее время не предлагает ни один другой инструмент с открытым исходным кодом для обеспечения соответствия — полностью офлайн, воспроизводимо и независимо от какого-либо API поставщика.

Типичное использование:

• эмпирические доказательства поведения модели для документации по предвзятости/справедливости в соответствии со ст. 10
• воспроизводимая локальная оценка до и после обновления модели
• добавление слоя поведенческих доказательств поверх структурных доказательств из scan

Рабочий процесс 4: Импорт внешнего SBOM CycloneDX

Преобразование внешнего CycloneDX JSON-файла в слой AI BOM 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

Будет создан:

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

Важные замечания:

• import принимает CycloneDX JSON и преобразует только подмножество, относящееся к ИИ, в euconform.aibom.v1.1
• --scope production исключает компоненты optional и excluded
• импортёр намеренно консервативен и не делает выводы о возможностях соответствия на основе SBOM
• название проекта может браться из метаданных BOM или имени исходного файла, в зависимости от входных данных

Попробуйте формат за 10 минут

Если вы хотите оценить текущий путь внедрения в качестве разработчика OSS, используйте один из референсных проектов в examples/:

# 1. Собрать CLI
pnpm --filter @euconform/cli build

# 2. Сканировать референсный проект
node packages/cli/dist/index.js scan examples/ollama-chatbot \
  --scope production \
  --output /tmp/euconform-ollama

# 3. Проверить созданный пакет
node packages/cli/dist/index.js verify /tmp/euconform-ollama/euconform.bundle.json

# 4. Открыть веб-приложение и импортировать созданные артефакты
pnpm dev

Для примера с приоритетом поиска замените examples/ollama-chatbot на examples/rag-assistant.

Использование с локальными моделями ИИ (опционально)

Для улучшенного обнаружения предвзятости с вашими собственными моделями:

1. Установите Ollama: Скачайте с ollama.ai
2. Загрузите модель: ollama pull llama3.2
3. Запустите Ollama: ollama serve
4. Выберите "Ollama" в веб-интерфейсе

Поддерживаются варианты Llama, Mistral и Qwen с автоматическим определением лог-вероятности.

[!WARNING] Развёртывание на Vercel / в облаке: Для этой функции требуется запускать EuConform локально (pnpm dev).

📖 Документация

Правовая основа и охват соответствия

[!NOTE] Основной правовой источник: Регламент (ЕС) 2024/1689 (EU AI Act)

Охват инструмента:

График внедрения: Обязательства вступают в силу поэтапно. Обязательства для высокого риска применяются с 2027 года. Всегда проверяйте актуальные руководства и делегированные акты.

CLI-сканер и CI

CLI EuConform спроектирован как переиспользуемая инфраструктура для доказательств:

• euconform scan создаёт нативные артефакты EuConform из репозитория.
• euconform bias предоставляет отличительный эмпирический слой доказательств поведения модели от EuConform.
• euconform validate проверяет отдельные JSON-файлы EuConform на соответствие опубликованным схемам.
• euconform verify проверяет целостность набора артефактов для манифестов, директорий и ZIP-пакетов.
• euconform import связывает внешний CycloneDX JSON со слоем AI BOM EuConform.

Веб-приложение остаётся местом для классификации ролей и рисков с учётом человеческого контекста.

Пример GitHub Actions

- name: Собрать CLI
  run: pnpm --filter @euconform/cli build

- name: Запустить сканирование EuConform
  run: node packages/cli/dist/index.js scan . --scope production --ci github --fail-on high

В GitHub Actions EuConform выдаёт:

• аннотации рабочего процесса для основных пробелов в соответствии
• сводку шага в формате Markdown
• машиночитаемые артефакты CI: euconform.ci.json и euconform.ci-summary.md

Формат доказательств EuConform

EuConform реализует EuConform Evidence Format — открытую спецификацию для портативных, машиночитаемых доказательств соответствия ИИ.

• euconform.report.v1 фиксирует доказательства соответствия, пробелы и открытые вопросы
• euconform.aibom.v1 — слой инвентаризации AI Bill of Materials (AI BOM)
• euconform.ci.v1 фиксирует пороги CI, статус и основные выводы
• euconform.bundle.v1 связывает наборы артефактов в портативный, целостный манифест

Текущие границы рабочих процессов:

• scan создаёт нативные артефакты EuConform из исходных репозиториев
• import может поглощать внешний CycloneDX JSON в текущий слой AIBOM для рабочих процессов интероперабельности
• validate делает историю схем и совместимости проверяемой на уровне JSON-документов
• verify проверяет целостность портативных пакетов перед обменом или автоматизацией

Документация этапа 1, схемы и примеры артефактов находятся в docs/spec/README.md. Референсные исходные проекты для разработчиков OSS находятся в examples/README.md.

Методология тестирования предвзятости

Мы используем методологию CrowS-Pairs (Nangia et al., 2020) для измерения социальных предвзятостей в языковых моделях.

Методы вычисления

[!TIP] Для наилучшей точности используйте Ollama v0.1.26+ с моделями, поддерживающими параметр logprobs (Llama 3.2+, Mistral 7B+).

Заявление об этике

Комбинации стереотипов используются исключительно для научной оценки и не отражают мнения разработчиков. Отдельные комбинации не отображаются в интерфейсе, чтобы не усиливать вредные стереотипы — показываются только агрегированные метрики.

Пользовательские тестовые наборы

Создавайте предметно-ориентированные тесты предвзятости, загружая собственные тестовые примеры:

[!TIP] Пользовательские тестовые наборы обрабатываются полностью в вашем браузере — ваши собственные тестовые примеры никогда не покидают ваше устройство.

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

🏗️ Структура проекта

euconform/
├── apps/
│   ├── web/                  # Рабочее приложение Next.js 16
│   └── docs/                 # Сайт документации (в разработке)
├── packages/
│   ├── cli/                  # Локальный сканер репозитория и интеграция с CI
│   ├── core/                 # Движок рисков, сканера, метрик справедливости, типы
│   ├── ui/                   # Общие UI-компоненты (shadcn-стиль)
│   ├── typescript-config/    # Общая конфигурация TypeScript
│   └── tailwind-config/      # Общая конфигурация Tailwind
├── .github/
│   ├── workflows/            # CI/CD пайплайны
│   └── ISSUE_TEMPLATE/       # Шаблоны issue
├── biome.json                # Конфиг линтера Biome
└── turbo.json                # Конфиг пайплайна Turborepo

🧪 Тестирование

# Запуск модульных тестов
pnpm test

# Запуск с покрытием
pnpm test -- --coverage

# Запуск E2E-тестов (требуется Playwright)
pnpm test:e2e

# Проверка типов
pnpm check-types

# Линтинг
pnpm lint

🛠️ Технологический стек

❓ Часто задаваемые вопросы

🤝 Участие

Мы приветствуем вклад! Пожалуйста, ознакомьтесь с нашим Руководством по участию и Кодексом поведения.

# Форкните и клонируйте
git clone https://github.com/yourusername/EuConform.git
cd EuConform

# Установите и разрабатывайте
pnpm install
pnpm dev

# Перед отправкой
pnpm lint && pnpm check-types && pnpm test

См. CONTRIBUTING.md для подробных рекомендаций.

🔒 Безопасность

По вопросам безопасности см. нашу Политику безопасности. Не создавайте публичные issue для уязвимостей безопасности.

📄 Лицензия

Двойная лицензия:

• MIT License – для максимальной совместимости
• EUPL-1.2 – для совместимости с учреждениями ЕС

Сделано с ❤️ для ответственного ИИ в Европе

Issues · Discussions