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 治理制度（例如欧盟 AI 法案）所需的文档，并向审计员或其他系统证明这些证据。

核心能力

领域	Attestix 提供的内容
身份	统一的代理身份令牌 (UAIT)，结合了 OAuth、DID（`did:key`、`did:web`）、API 密钥和自定义格式。包含本地擦除工具。
可验证凭证	完整的 W3C 可验证凭证 (VC) 签发，带有 Ed25519Signature2020 证明，以及用于质询-响应验证的可验证演示 (VP)。
委派	基于 UCAN 风格的能力令牌（EDDSA 签名的 JWT），用于代理之间的细粒度委派。
合规性	预构建的欧盟 AI 法案风险概况模板、差距分析，以及包装在 VC 中的附件 V 声明的自动生成。
来源	记录训练数据来源（第 10 条）、模型谱系（第 11 条）和哈希链审计跟踪（第 12 条）。
声誉	基于近期性的信任分数（0 → 1），带有按类别细分。
区块链锚定	可选地将工件哈希通过以太坊证明服务 (EAS) 使用 Merkle 批处理锚定到 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️⃣ 记录合规配置文件（欧盟 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>             # 针对欧盟 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 工具定义（每个模块一个文件）

0.4 之前的扁平布局保留为弃用垫片，会发出警告并将在 v0.5.0 中移除。

何时（以及为何）使用 Attestix

AI 治理管道 – 自动生成欧盟 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 包。