VibeTensor/attestix

AI agent identity, signed credentials, delegated authority and portable governance evidence. Python core and offline verifier SDKs.

Attestix – AI 에이전트를 위한 서명된 ID 및 증거

정의 – Attestix는 AI 에이전트를 위한 암호화 검증 가능한 ID와 증거를 생성, 서명, 저장 및 검증할 수 있는 오픈 소스 툴킷입니다. Python 라이브러리, CLI, FastAPI 기반 REST 서버 및 Streamlit 대시보드와 함께 언어별 검증 패키지(JS/TS, Go, Rust, Java, R)를 번들로 제공합니다. 목표는 개발자에게 AI 거버넌스 체제(예: EU AI Act)에서 요구하는 문서를 기록하고 해당 증거를 감사자나 다른 시스템에 입증할 수 있는 구체적인 방법을 제공하는 것입니다.

핵심 기능

영역	Attestix가 제공하는 것
ID	OAuth, DID(`did:key`, `did:web`), API 키 및 사용자 지정 형식을 결합한 통합 에이전트 ID 토큰(UAIT). 로컬 삭제 도구가 포함되어 있습니다.
검증 가능한 자격 증명	Ed25519Signature2020 증명이 포함된 완전한 W3C 검증 가능한 자격 증명(VC) 발급 및 챌린지-응답 검증을 위한 검증 가능한 프레젠테이션(VP).
위임	에이전트 간 세분화된 위임을 위한 UCAN 스타일 기능 토큰(EDDSA 서명 JWT).
규정 준수	사전 구축된 EU AI Act 위험 프로필 템플릿, 격차 분석 및 VC에 래핑된 부속서 V 선언 자동 생성.
출처	훈련 데이터 소스(제10조), 모델 계보(제11조) 및 해시 체인 감사 추적(제12조) 기록.
평판	카테고리별 세부 정보가 포함된 최근성 가중 신뢰 점수(0 → 1).
블록체인 앵커링	Merkle 배치를 사용하여 Ethereum Attestation Service(EAS)를 통해 Base L2에 아티팩트 해시를 선택적으로 앵커링.
상호 운용성	언어에 구애받지 않는 검증 라이브러리 및 표준 JSON + Ed25519 프로필; 각 언어에 대한 적합성 픽스처가 게시됩니다.

설치(Python – 참조 구현)

# 최신 검토 릴리스 고정
pip install attestix==0.4.2

선택적 추가 기능:

pip install 'attestix[api]' – REST 서버용 FastAPI/uvicorn을 가져옵니다.
pip install streamlit – 웹 대시보드를 활성화합니다.

다른 언어는 해당 패키지를 설치합니다(예: npm install attestix@0.4.2, go get github.com/VibeTensor/attestix-go@v0.4.2).

빠른 시작(Python 라이브러리)

from attestix.services.identity_service import IdentityService
from attestix.services.compliance_service import ComplianceService
from attestix.services.credential_service import CredentialService

# 1️⃣ 에이전트 ID 생성 (UAIT + DID)
identity_svc = IdentityService()
agent = identity_svc.create_identity(
    display_name="MyAgent",
    source_protocol="manual",
    capabilities=["data_analysis", "reporting"],
    description="Analyzes quarterly financial data",
    issuer_name="VibeTensor",
    expiry_days=365,
)
agent_id = agent["agent_id"]

# 2️⃣ 규정 준수 프로필 기록 (EU AI Act 위험 분류)
compliance_svc = ComplianceService()
profile = compliance_svc.create_compliance_profile(
    agent_id=agent_id,
    risk_category="limited",
    provider_name="VibeTensor",
    intended_purpose="Analyzes quarterly financial data",
)

# 3️⃣ 에이전트용 검증 가능한 자격 증명 발급
credential_svc = CredentialService()
vc = credential_svc.issue_credential(
    subject_id=agent_id,
    credential_type="AgentIdentityCredential",
    issuer_name="VibeTensor",
    claims={"capabilities": ["data_analysis", "reporting"]},
    expiry_days=365,
)
print(vc["proof"]["type"])   # → Ed25519Signature2020

번들 데모를 실행하여 전체 워크플로를 확인합니다:

python examples/quickstart.py

CLI 사용

attestix init --name MyBot                 # 새 에이전트 ID 생성
attestix compliance <agent-id>             # EU AI Act에 대한 격차 분석 실행
attestix verify <agent-id>                 # ID를 암호화 검증
attestix audit <agent-id>                  # 해시 체인 감사 추적 보기
attestix credential --list                 # 저장된 검증 가능한 자격 증명 나열

REST 서버 실행(LangChain, OpenAI Agents SDK, CrewAI 등과의 통합용)

export ATTESTIX_API_KEY=your-secret-key   # 기본적으로 필요
uvicorn attestix.api.main:app --reload    # Swagger UI는 http://localhost:8000/docs

API는 라이브러리와 동일한 네임스페이스(`attestix.*`)를 따르며 ID, 자격 증명 발급, 위임, 규정 준수, 출처 및 블록체인 앵커링을 위한 엔드포인트를 노출합니다.

아키텍처 개요

attestix/                     # Python 패키지
 ├─ main.py                  # MCP 서버 진입점
 ├─ cli.py                   # 콘솔 스크립트 (attestix)
 ├─ api/                     # FastAPI 표면
 │   └─ routers/ …
 ├─ auth/                    # Ed25519 키 처리, SSRF 보호
 ├─ services/                # 비즈니스 로직 모듈(ID, DID, 자격 증명 등)
 ├─ storage/                 # 플러그 가능한 백엔드(파일, 메모리, PostgreSQL)
 ├─ signing/                 # 프로세스 내 서명자 또는 외부 KMS
 ├─ audit/                   # 변조 방지 이벤트 체인(SHA-256)
 ├─ blockchain/              # Merkle 트리 + EAS 앵커링 헬퍼
 └─ tools/                   # MCP 도구 정의(모듈당 하나의 파일)

0.4 이전의 플랫 레이아웃은 더 이상 사용되지 않는 심으로 유지되며 경고를 발행하고 v0.5.0에서 제거됩니다.

Attestix를 사용하는 경우(및 이유)

AI 거버넌스 파이프라인 – EU AI Act 준수에 필요한 서명된 증거(위험 프로필, 데이터 출처, 모델 계보, 적합성 선언)를 자동 생성합니다.
멀티 에이전트 생태계 – 각 자율 구성 요소에 검증 가능한 DID 기반 ID를 제공하고 UCAN 토큰을 통해 기능을 안전하게 위임합니다.
감사 가능한 배포 – 모든 작업을 해시 체인으로 연결하고 중요한 해시를 온체인에 앵커링하며 규제 기관이나 고객을 위해 변조 방지 감사 로그를 검색합니다.
크로스 언어 검증 – 게시된 표준 JSON 프로필을 사용하여 Python, JavaScript, Go, Rust, Java 또는 R에서 동일한 자격 증명을 검증합니다.

주의 사항 및 보안 참고 사항(README에 명시된 대로)

프로젝트는 1.0 이전입니다. 제3자 보안 감사가 수행되지 않았습니다.
재생 보호는 검증자가 새로운 챌린지를 제공할 때만 적용됩니다. 원시 서명만으로는 충분하지 않습니다.
기본 REST 서버는 단일 테넌트입니다. API 키는 교차 테넌트 액세스를 허용하지 않습니다.
로컬 삭제는 로컬에 저장된 레코드만 제거합니다. 외부 복제본, 백업 또는 온체인 앵커는 별도로 처리해야 합니다.
legal_conformity 필드는 초안입니다. 법적 평가를 구성하지 않습니다.

문서 및 커뮤니티

문서: https://attestix.io/docs
웹사이트: https://attestix.io
소스: https://github.com/VibeTensor/attestix
이슈 트래커: 버그, 기능 요청 및 보안 공개에 대해 열려 있습니다.
기여: 환영합니다. 프로젝트는 단일 유지 관리자 모델을 따르지만 커뮤니티 PR을 수락합니다.

결론: Attestix는 개발자에게 신뢰할 수 있는 AI 에이전트 ID를 생성하고, 새로운 규정에서 요구하는 증거를 기록하며, 해당 증거를 다른 서비스나 감사자에게 입증하기 위한 즉시 사용 가능한 암호화 지원 스택을 제공합니다. 이 모든 것은 언어에 구애받지 않는 검증 지원을 갖춘 단일 Python 패키지에서 제공됩니다.