AxiomID is the Human Authorization Protocol for AI agents and humans.

Pi Browser auth, sovereign passports, verifiable identity, and agent governance in one experience.

Live App · Demo Passport · Leaderboard · GitHub

---

AxiomID is a Next.js application that combines Pi Network authentication, passport-style identity claims, and a lightweight governance layer for human-AI collaboration.

What is available now

• Pi Browser sign-in and callback handling
• Demo and real identity claim flows
• Public passport pages with trust and badge metadata
• Authenticated dashboard with marketplace, settings, and sandbox playground
• Explorer, leaderboard, docs, and service status views
• API routes for auth, passport publishing, Pi payments, and health checks
• Spend Request — agentic Pi payments pipeline (agent requests, user approves, Pi SDK executes)
• TrustChain — append-only hash chain for all agent actions
• Truth RAG — AI-powered Q&A over 6236 verses via Vectorize + Workers AI

Routes

Route	Purpose
/	Landing experience and entry point
/claim	Identity claim wizard
/passport/[slug]	Public passport viewer
/dashboard	Authenticated dashboard
/explorer	Discover agents and identities
/leaderboard	Ranked trust and activity view
/docs	Product and API documentation
/status	Service health and dependency status

API Routes

Endpoint	Purpose
/api/auth/*	Pi Browser authentication
/api/passport/*	Passport CRUD and publishing
/api/payments/*	Pi payment creation and completion
/api/spend-request	Create and list spend requests
/api/spend-request/[id]	Approve, reject, or complete spend requests
/api/spend-request/stream	SSE stream for agent notifications
/api/health	Health check

Tech stack

Layer	Technology
Frontend	Next.js 16 · React 19 · Framer Motion 12 · Tailwind 4
Backend	Vercel Serverless · Cloudflare Workers
Database	PostgreSQL (Prisma 6) · D1 (edge sync) · Vectorize (semantic search)
Cache	Upstash Redis (rate limiting, session state)
AI	Workers AI — Llama 3.1 8B · BGE-small-en-v1.5
Auth	Pi Network SDK · Ed25519 sovereign keys · W3C DID
Storage	Cloudflare KV · Vercel Blob
CI/CD	GitHub Actions → Vercel · 3272 tests, 168 suites

Quick start

git clone https://github.com/Moeabdelaziz007/AxiomID.git
cd AxiomID
npm install
cp .env.example .env.local
# Fill in: DATABASE_URL, PI_API_KEY, SOVEREIGN_KEY_SALT, auth secrets
npx prisma migrate deploy && npx prisma generate
npm run dev

Open http://localhost:3000.

Pi Browser local HTTPS

The Pi SDK expects HTTPS in the browser. For local development, use portless:

npm install -g portless
portless axiomid next dev
# -> https://axiomid.localhost

Backend (Cloudflare Worker)

cd backend && npm install
npx wrangler d1 execute axiomid-edge --remote --file=./migrations/0001_init.sql
echo "token" | npx wrangler secret put SHARED_SECRET_TOKEN_VERCEL_CF
npx wrangler deploy

Verification and quality checks

npm run lint       # 0 errors, 0 warnings
npm run type-check # type check
npm test           # 3272 tests, 168 suites

Project structure

src/
  app/
    api/           # Route handlers (Next.js App Router)
    dashboard/     # Authenticated dashboard
    passport/      # Public passport viewer
  components/      # Shared UI components
  lib/             # Auth, crypto, Pi SDK, validators, utilities
  i18n/            # Translation files (en.json, ar.json)
prisma/            # Schema and migrations
docs/              # Specs and architecture docs
AxiomID.Memory/    # Knowledge base and design docs

Trust Tiers

Tier	XP	Access
Visitor	0	Limited. Basic read-only.
Citizen	100	Social stamps, basic agent access.
Validator	500	Agent delegation, marketplace install.
Sovereign	1000	Full trust, vault staking, vouching power.

Trust Score

Every identity on AxiomID has a Trust Score built from verified stamps and experience points (XP):

$$\text{Trust Score} = \text{XP Score} \times 0.5 + \text{Stamp Score} \times 0.2 + \text{Tenure Score} \times 0.1 + \text{Semantic Trust} \times 0.2$$

Trust decays over time (inactivity penalty) and is boosted by Stellar anchoring (+15%).

What AxiomID Does

Layer	What It Does
DID	did:axiom — W3C-compliant, self-sovereign identity per user
Verifiable Credentials	Cryptographically signed stamps (social, KYA, KYC)
Trust Engine	Physics-inspired algorithm with decay and anchoring
Agent Passports	Public identity cards with verification badges and trust scores
Spend Request	Agentic Pi payments — agent requests, user approves, Pi SDK executes
TrustChain	Append-only hash chain for all agent actions
Skills Marketplace	Install capabilities for agents
Truth RAG	AI-powered Q&A over 6236 verses via Vectorize + Workers AI
Soul System	Six-gate ethical evaluation loop

Contributing

See CONTRIBUTING.md. PRs require passing CI.

git checkout -b feat/my-feature
# make changes
npm test && npm run lint && npx tsc --noEmit
git commit -m "feat(scope): description ۞"
git push origin feat/my-feature

License

• Application code: Proprietary — All Rights Reserved © 2026 Mohamed Abdelaziz. See LICENSE.
• @axiomid/sdk and @axiomid/crypto: MIT licensed. Open for community use.

Built By

AxiomID is built by Mohamed Abdelaziz (@Moeabdelaziz007).

Built with passion in Cairo, Egypt.

Acknowledgments

Pi Network — For the authentication SDK and the vision of a human-centered web. Learn more at minepi.com.

---

axiomid.app · Claim your identity

_{Built with the belief that every human deserves a sovereign digital identity.}