Catalog PyPI
PACKAGE EXPLORERView in registry

agentity-registry

PyPI

Agentity Protocol Registry — REST API for DID lookup, revocation, WebSocket, audit

Versions collected1
Direct dependencies12From release 0.1.1
Last observed20 Oct, 22:29 UTC

README

Version 0.1.1 documentation

agentity-registry

FastAPI REST registry for the Agentity Protocol. Register agent identities, lookup DID status, revoke tokens, stream events via WebSocket — with OIDC auth, rate limiting, and signed audit logs.

Installation

pip install agentity-registry

Quick start

# In-memory (no dependencies)
uvicorn agentity_registry.main:app --port 8000

# With OIDC auth
cp .env.example .env   # fill in Google/GitHub credentials
uvicorn agentity_registry.main:app --port 8765

# Production (PostgreSQL + Redis)
AGENTITY_STORE=postgres docker compose up -d

Endpoints

MethodPathDescription
GET/healthHealth check + store + auth info
POST/registerRegister an agent AID
GET/did/{did}Get full AID document
GET/did/{did}/statusGet AID status (active/revoked/expired)
POST/revokeRevoke an AID (optional cascade)
GET/agentsList all registered agents
GET/auditGet all audit log entries
GET/audit/{did}Get audit log for a specific DID
GET/audit/{did}/verifyVerify an audit entry signature
WS/wsReal-time event stream (created/revoked)

Authentication endpoints (if OIDC enabled)

MethodPathDescription
GET/auth/login/{provider}OIDC login (google, github, apple, microsoft)
GET/auth/callback/{provider}OIDC callback
GET/auth/session/{token}Get verified owner session

Configuration

Env varDefaultDescription
AGENTITY_STOREmemorymemory or postgres
REDIS_URLredis://localhost:6379Redis for rate limiting
DATABASE_URLpostgresql://...PostgreSQL connection
AGENTITY_EVM_RPC_URL—Optional EVM bridge RPC

OIDC env vars

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, APPLE_CLIENT_ID, APPLE_CLIENT_SECRET, MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET

Features

  • Pluggable storage — InMemoryStore (dev) / PostgresStore (prod)
  • Rate limiting — Redis-backed, 100 req/min per DID, X-RateLimit-Remaining header
  • Signed audit log — HMAC-SHA256 on each entry, verifiable
  • WebSocket broadcasts — Real-time revocation events
  • EVM bridge — Optional on-chain DID registration (via agentity-evm)

Tests

pip install -e .[dev]
pytest agentity_registry/tests/

License: Apache 2.0

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.117 May 202612

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
agenttity/agentity

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 22:29 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:62b97f4ee90db7f550294bafd040ea580bfde5b005d50c0582d18f24b0304756