VibeTensor/attestix

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

Attestix – AI エージェント向け署名付きアイデンティティと証拠

概要 – Attestix は、AI エージェント向けに暗号検証可能なアイデンティティと証拠を作成、署名、保存、検証できるオープンソースツールキットです。Python ライブラリ、CLI、FastAPI ベースの REST サーバー、Streamlit ダッシュボードに加え、言語固有の検証パッケージ（JS/TS、Go、Rust、Java、R）をバンドルしています。目標は、AI ガバナンス体制（例：EU AI 法）で必要とされる文書を記録し、その証拠を監査人や他のシステムに証明する具体的な方法を開発者に提供することです。

中核機能

領域	Attestix が提供するもの
アイデンティティ	OAuth、DID（`did:key`、`did:web`）、API キー、カスタム形式を組み合わせた統一エージェントアイデンティティトークン (UAIT)。ローカル消去ツールも含まれます。
検証可能な資格情報	Ed25519Signature2020 証明による完全な W3C 検証可能資格情報 (VC) の発行に加え、チャレンジレスポンス検証用の検証可能プレゼンテーション (VP)。
委任	エージェント間のきめ細かい委任のための UCAN スタイルの能力トークン（EDDSA 署名付き JWT）。
コンプライアンス	事前構築された EU AI 法リスクプロファイルテンプレート、ギャップ分析、VC にラップされた附属書 V 宣言の自動生成。
来歴	トレーニングデータソース（第 10 条）、モデル系統（第 11 条）、ハッシュチェーン監査証跡（第 12 条）の記録。
評判	カテゴリ別内訳付きの最近性加重信頼スコア（0 → 1）。
ブロックチェーンアンカリング	Merkle バッチ処理を使用したイーサリアム証明サービス (EAS) による Base L2 へのアーティファクトハッシュのオプションのアンカリング。
相互運用性	言語に依存しない検証ライブラリと正規 JSON + Ed25519 プロファイル。各言語向けに適合性フィクスチャが公開されています。

インストール（Python – リファレンス実装）

# 最新のレビュー済みリリースを固定
pip install attestix==0.4.2

オプションの追加機能：

pip install 'attestix[api]' – REST サーバー用に FastAPI/uvicorn を取得します。
pip install streamlit – Web ダッシュボードを有効にします。

他の言語では対応するパッケージをインストールします（例：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️⃣ エージェントアイデンティティを作成 (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 法リスク分類）
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                 # 新しいエージェントアイデンティティを作成
attestix compliance <agent-id>             # EU AI 法に対するギャップ分析を実行
attestix verify <agent-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.*`）に従い、アイデンティティ、資格情報発行、委任、コンプライアンス、来歴、ブロックチェーンアンカリング用のエンドポイントを公開します。

アーキテクチャ概要

attestix/                     # Python パッケージ
 ├─ main.py                  # MCP サーバーエントリポイント
 ├─ cli.py                   # コンソールスクリプト (attestix)
 ├─ api/                     # FastAPI サーフェス
 │   └─ routers/ …
 ├─ auth/                    # Ed25519 キー処理、SSRF 保護
 ├─ services/                # ビジネスロジックモジュール（アイデンティティ、DID、資格情報など）
 ├─ storage/                 # プラグ可能なバックエンド（ファイル、メモリ、PostgreSQL）
 ├─ signing/                 # プロセス内署名者または外部 KMS
 ├─ audit/                   # 改ざん防止イベントチェーン (SHA-256)
 ├─ blockchain/              # Merkle ツリー + EAS アンカリングヘルパー
 └─ tools/                   # MCP ツール定義（モジュールごとに 1 ファイル）

0.4 より前のフラットレイアウトは非推奨のシムとして保持され、警告を発し、v0.5.0 で削除されます。

Attestix を使用する場合（およびその理由）

AI ガバナンスパイプライン – EU AI 法コンプライアンスに必要な署名付き証拠（リスクプロファイル、データ来歴、モデル系統、適合宣言）を自動生成します。
マルチエージェントエコシステム – 各自律コンポーネントに検証可能な DID ベースのアイデンティティを提供し、UCAN トークンを介して能力を安全に委任します。
監査可能なデプロイメント – すべてのアクションをハッシュチェーンし、重要なハッシュをオンチェーンにアンカーし、規制当局や顧客向けに改ざん防止の監査ログを取得します。
クロス言語検証 – 公開された正規 JSON プロファイルを使用して、Python、JavaScript、Go、Rust、Java、または R で同じ資格情報を検証します。

注意事項とセキュリティノート（README に記載されているとおり）

プロジェクトは 1.0 より前です。サードパーティによるセキュリティ監査は実施されていません。
リプレイ保護は、検証者が新しいチャレンジを提供した場合にのみ強制されます。生の署名だけでは不十分です。
デフォルトの REST サーバーはシングルテナントです。API キーはクロステナントアクセスを許可しません。
ローカル消去はローカルに保存されたレコードのみを削除します。外部レプリカ、バックアップ、またはオンチェーンアンカーは個別に処理する必要があります。
legal_conformity フィールドはドラフトです。法的評価を構成するものではありません。

ドキュメントとコミュニティ

ドキュメント： https://attestix.io/docs
ウェブサイト： https://attestix.io
ソース： https://github.com/VibeTensor/attestix
問題トラッカー： バグ、機能リクエスト、セキュリティ開示のために開かれています。
貢献： 歓迎します。プロジェクトは単一メンテナモデルに従いますが、コミュニティ PR を受け入れます。

結論： Attestix は、信頼できる AI エージェントアイデンティティを作成し、新興規制で必要とされる証拠を記録し、その証拠を他のサービスや監査人に証明するための、すぐに使える暗号サポート付きスタックを開発者に提供します。すべて、言語に依存しない検証サポートを備えた単一の Python パッケージから実現できます。