EuConform

🇪🇺 AI 규정 준수를 위한 오픈소스 증거 도구 키트

개방형 증거 형식 • 로컬 편향 평가 • 스키마 검증 • CycloneDX 상호운용성
오프라인 우선 • 개인정보 보호 • 재사용 가능한 아티팩트 • WCAG 2.2 AA 접근 가능

EuConform은 AI 규정 준수를 위한 개방형 증거 형식을 정의하고, 이를 생성, 검증 및 경험적으로 평가할 수 있는 도구를 제공합니다 — 오프라인 및 벤더 독립적으로.

[!IMPORTANT] 법적 고지사항: 이 도구는 기술적 지침만 제공합니다. 법적 조언을 구성하지 않으며, 공인 기관의 법적 구속력 있는 적합성 평가 또는 전문 법률 상담을 대체하지 않습니다. 항상 자격을 갖춘 법률 전문가에게 규정 준수 결정을 문의하십시오.

🚀 빠른 시작 · 📖 문서 · 🌐 Deploy · 🐛 버그 신고

✨ 기능

🧰 CLI 한눈에 보기

🚀 빠른 시작

설치하지 않고 시도해보고 싶으신가요? 위의 🌐 Deploy 링크를 클릭하여 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

일반적인 출력:

• euconform.aibom.json — valid (euconform.aibom.v1)와 같은 파일당 한 줄
• 종료 코드 0: 완전 유효 입력, 1: 스키마 오류, 2: EuConform JSON 파일을 찾을 수 없는 경우

번들 매니페스트, 추출된 번들 디렉터리 또는 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. 웹 앱을 열고 생성된 아티팩트 가져오기
pnpm dev

검색 우선 예제의 경우 examples/ollama-chatbot을 examples/rag-assistant로 바꾸세요.

로컬 AI 모델과 함께 사용하기 (선택 사항)

자체 모델로 향상된 편향 감지를 위해:

1. Ollama 설치: ollama.ai에서 다운로드
2. 모델 가져오기: ollama pull llama3.2
3. Ollama 시작: ollama serve
4. 웹 인터페이스에서 "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 계층으로 연결합니다.

웹 앱은 인간 맥락을 포함한 역할 및 위험 분류를 위한 장소로 유지됩니다.

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은 다음을 생성합니다:

• 주요 규정 준수 격차에 대한 워크플로 주석
• 마크다운 단계 요약
• 기계 판독 가능 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/                 # 문서 사이트 (작업 중)
├── packages/
│   ├── cli/                  # 로컬 저장소 스캐너 및 CI 통합
│   ├── core/                 # 위험 엔진, 스캐너 엔진, 공정성 지표, 타입
│   ├── ui/                   # 공유 UI 컴포넌트 (shadcn 스타일)
│   ├── typescript-config/    # 공유 TypeScript 구성
│   └── tailwind-config/      # 공유 Tailwind 구성
├── .github/
│   ├── workflows/            # CI/CD 파이프라인
│   └── ISSUE_TEMPLATE/       # 이슈 템플릿
├── biome.json                # Biome 린터 구성
└── turbo.json                # Turborepo 파이프라인 구성

🧪 테스트

# 단위 테스트 실행
pnpm test

# 커버리지로 실행
pnpm test -- --coverage

# E2E 테스트 실행 (Playwright 필요)
pnpm test:e2e

# 타입 검사
pnpm check-types

# 린팅
pnpm lint

🛠️ 기술 스택

❓ 자주 묻는 질문 (FAQ)

🤝 기여하기

기여를 환영합니다! 먼저 기여 가이드와 행동 강령을 읽어주세요.

# 포크 및 클론
git clone https://github.com/yourusername/EuConform.git
cd EuConform

# 설치 및 개발
pnpm install
pnpm dev

# 제출 전
pnpm lint && pnpm check-types && pnpm test

자세한 지침은 CONTRIBUTING.md를 참조하세요.

🔒 보안

보안 관련 사항은 보안 정책을 참조하세요. 보안 취약점에 대해 공개 이슈를 생성하지 마십시오.

📄 라이선스

다음에 따라 이중 라이선스:

• MIT 라이선스 – 최대 호환성
• EUPL-1.2 – EU 기관 호환성

유럽의 책임 있는 AI를 위해 ❤️로 제작됨

이슈 · 토론