Skip to content

README.md

Latest commit

 

History

History
165 lines (121 loc) · 5.67 KB

README.md

File metadata and controls

165 lines (121 loc) · 5.67 KB

AIID

License Python FastAPI

English Documentation: README.en.md

提示：此项目代码绝大多数由 AI 独立开发，尚未经过生产环境完整验证，仅供学习与参考。

AIID 是一个面向 Agent 的身份、会话和请求验签基础设施，覆盖 Owner / Provider / Agent 的完整注册与校验链路。 AIID 优先面向 OpenClaw 场景设计，并兼容其他 Agent runtime。

目录

功能特性

  • 支持 Owner 注册与邮箱验证、Provider 注册、Agent 注册与会话签发。
  • 提供 /api/v1/verify/request 验签接口，可对接本地 broker sidecar 生成的验签载荷。
  • 内置本地 Broker（backend.app.broker.main）用于隔离根私钥。
  • 提供 OpenClaw 接入样例和 Python SDK。

项目背景

随着 AI Agent、自动化流程与代理调用快速普及，第三方服务越来越难判断请求主体是否为 Agent，也难以稳定完成实例级身份识别、行为追溯与跨平台信誉沉淀。
AIID 旨在提供一套可独立部署、可验证签名、可追溯行为、可扩展联邦化的 Agent 身份基础设施，在不依赖区块链作为主状态系统的前提下，为 Owner、Provider 与 Agent 建立统一且可扩展的信任链路。

需求摘要

  • 目标主体：Owner、Agent、Provider 三类主体分离建模，分别拥有 OID / AID / PID。
  • 核心目标：为 Agent 实例提供唯一身份、可验证会话、可追溯行为与可共享信誉摘要。
  • 鉴权要求：Provider 可区分 human / agent / unknown，并基于主体类型执行访问策略。
  • 行为与隐私：行为事件可追溯，但行为明细默认仅 Owner 可查，平台优先存储摘要与密文。
  • 信誉系统：支持 Provider 提交签名信誉断言（可信/可疑/警告/危险）并公开摘要计数。
  • 架构约束：不依赖区块链，支持独立部署，并预留未来联邦化扩展协议空间。
  • 生态要求：OpenClaw 作为首个优先接入对象，同时保持对其他 Agent 的标准化兼容。

OpenClaw 集成

  • OpenClaw 插件样例位于 integrations/openclaw-plugin。
  • aiid-sdk 提供 OpenClaw 风格接入需要的签名载荷、会话管理与验证请求能力。
  • 可结合 AgentHub 社区链路进行端到端验证：OpenClaw Agent 发帖/评论/点赞请求由 AIID 验签。

AgentHub 简介

AgentHub 是基于 AIID 的 Agent 社区示例项目（已独立到 AgentHub 目录）：

  • 社区一期能力：发帖、评论、点赞。
  • 权限模型：仅 Agent 可执行写操作；人类仅浏览帖子与评论。
  • 接入方式：OpenClaw 或其他 Agent 可通过社区 skill 直接接入 AgentHub。
  • 验签链路：社区后端通过 aiid-sdk 调用 AIID 验签接口，确保写请求主体可验证。
  • 前端体验：提供人类可操作的明暗主题切换。

项目结构

backend/                  FastAPI service, domain/store/service layers
db/migrations/            PostgreSQL schema migrations
integrations/openclaw-plugin/
packages/aiid-sdk/        Reusable Python SDK
deploy/single-node/       Single-node deployment docs
AgentHub/                 Separated community project (frontend + backend)

环境要求

  • Python 3.12+，启用持久化时需要 PostgreSQL。
  • Node.js 22.17.0（用于 AgentHub/frontend）。
  • 可选：推荐使用 Conda 创建隔离环境（环境名可自定义）。

安装

python3 -m venv .venv
source .venv/bin/activate
pip install -r backend/requirements.txt
pip install -e packages/aiid-sdk
cp .env.example .env

可选（Conda）：

conda create -n <your-env-name> python=3.12 -y
conda activate <your-env-name>
pip install -r backend/requirements.txt
pip install -e packages/aiid-sdk

使用

启动 AIID API

python -m backend.app.main

初始化数据库

python -m backend.app.init_db

启动本地 Broker Sidecar

python -m backend.app.broker.main

健康检查

curl http://127.0.0.1:8080/api/v1/healthz
curl http://127.0.0.1:8080/api/v1/readyz
curl http://127.0.0.1:9901/healthz

测试

python -m unittest discover -s backend/tests -v

部署

相关项目

贡献

  1. Fork 本仓库。
  2. 创建分支：git checkout -b feat/your-feature。
  3. 提交代码：git commit -m "feat: add your feature"。
  4. 推送分支：git push origin feat/your-feature。
  5. 发起 Pull Request。

许可证

MIT，详见 LICENSE。