EuConform

🇪🇺 オープンソースのAIコンプライアンス向けエビデンスツールキット

オープンエビデンス形式 • ローカルバイアス評価 • スキーマ検証 • CycloneDX相互運用性
オフラインファースト • プライバシー保護 • 再利用可能な成果物 • WCAG 2.2 AAアクセシビリティ対応

EuConformは、AIコンプライアンスのためのオープンなエビデンス形式を定義し、その生成、検証、実証的評価を行うためのツールを提供します — オフラインで、ベンダーに依存しません。

[!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または内部AIプロジェクトのエビデンス収集
• 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：既存成果物の検証と検証

個々のEuConform JSONドキュメントを公開スキーマに対して検証：

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

典型的な出力：

• ファイルごとに1行、例：euconform.aibom.json — valid (euconform.aibom.v1)
• 完全に有効な入力は終了コード0、スキーマエラーは1、EuConform JSONファイルが見つからない場合は2

バンドルマニフェスト、抽出済みバンドルディレクトリ、またはZIPアーカイブを検証：

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

一般的な使用例：

• 手動分析前のレビューア側でのスキーマチェック
• 他の場所で既に生成された成果物セットのCI健全性チェック
• バンドルをダウンストリームツールと共有する前の移植性チェック

ワークフロー3：ローカルでのモデルバイアス評価

ローカルのOllamaモデルに対して再現可能なCrowS-Pairsバイアス評価を実行：

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

これはEuConform独自の実証的エビデンスレイヤーです。完全にオフラインで、再現可能であり、いかなるベンダーAPIにも依存しない、現在他のどのオープンソースコンプライアンスツールも提供していないモデル動作データを生成します。

一般的な使用例：

• 第10条のバイアス/公平性文書化のための実証的なモデル動作エビデンス
• モデル更新前後の再現可能なローカル評価
• scanによる構造的エビデンスに加えて動作的エビデンスレイヤーを追加

ワークフロー4：外部CycloneDX SBOMのインポート

外部のCycloneDX JSONファイルをEuConform AI BOMレイヤーにマッピング：

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を受け入れ、AI関連のサブセットのみを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. Webアプリを開き、生成された成果物をインポート
pnpm dev

検索優先の例については、examples/ollama-chatbotをexamples/rag-assistantに置き換えてください。

ローカルAIモデルとの併用（オプション）

独自のモデルで拡張されたバイアス検出を行う場合：

1. Ollamaのインストール：ollama.aiからダウンロード
2. モデルのプル：ollama pull llama3.2
3. Ollamaの起動：ollama serve
4. Webインターフェースで「Ollama」を選択

Llama、Mistral、Qwenの各バリアントをサポートし、自動的に対数確率検出を行います。

[!WARNING] Vercel / クラウドデプロイメント: この機能はEuConformをローカルで実行する必要があります（pnpm dev）。

📖 ドキュメント

法的基盤とコンプライアンス範囲

[!NOTE] 一次法源: Regulation (EU) 2024/1689 (EU AI Act)

ツールの範囲：

実装スケジュール: 義務は段階的に発効します。ハイリスク義務は2027年から適用されます。常に最新のガイドラインと委任規則を確認してください。

CLIスキャナーとCI

EuConformのCLIは、再利用可能なエビデンスインフラストラクチャとして設計されています：

• euconform scanはリポジトリからネイティブEuConform成果物を生成します。
• euconform biasはEuConform独自の実証的なモデル動作エビデンスレイヤーを提供します。
• euconform validateは個々のEuConform JSONファイルを公開スキーマに対してチェックします。
• euconform verifyはマニフェスト、ディレクトリ、ZIPバンドルの成果物セットの整合性をチェックします。
• euconform importは外部のCycloneDX JSONをEuConform AI BOMレイヤーにブリッジします。

Webアプリは、人間のコンテキストを伴う役割およびリスク分類のための場所として残ります。

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

GitHub Actionsでは、EuConformは以下を出力します：

• 主要なコンプライアンスギャップに関するワークフロー注釈
• Markdownのステップサマリー
• 機械可読なCI成果物：euconform.ci.json および euconform.ci-summary.md

EuConformエビデンス形式

EuConformは、ポータブルで機械可読なAIコンプライアンスエビデンスのための公開仕様であるEuConformエビデンス形式を実装しています。

• euconform.report.v1はコンプライアンスエビデンス、ギャップ、未解決の質問をキャプチャします
• euconform.aibom.v1はAI部品表（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] 最高の精度を得るには、logprobsパラメータをサポートするモデル（Llama 3.2+、Mistral 7B+）でOllama v0.1.26+を使用してください。

倫理声明

ステレオタイプの組は科学的評価のみを目的として使用されており、開発者の意見を反映するものではありません。有害なステレオタイプを強化しないよう、UIには個々の組は表示されず、集計された指標のみが表示されます。

カスタムテストスイート

独自のテストケースをアップロードして、ドメイン固有のバイアステストを作成します：

[!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/                 # ドキュメンテーションサイト（WIP）
├── 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

🛠️ テクノロジースタック

❓ FAQ

🤝 コントリビューション

コントリビューションを歓迎します！最初にコントリビューションガイドと行動規範をお読みください。

# Forkしてクローン
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ライセンス – 最大限の互換性のため
• EUPL-1.2 – EU機関との互換性のため

ヨーロッパにおける責任あるAIのために ❤️ を込めて

Issues · Discussions