Quickstart

1. Install

pip install agentid

2. Register in the sandbox

from agentid import Registry

reg = Registry(sandbox=True)
agent = reg.register(
    name="atlas-logistics-bot",
    creator={"type": "organization", "name": "Atlas Freight Inc."},
    created="2026-03-14",
    place={"country": "US", "region": "CA", "city": "SF"},
    skills=["logistics", "pricing"],
    model="claude", kind="autonomous",
)
print(agent.aid)            # AID-XX-CA-SF-2026-000001-K7
agent.save_private_key("agent.key")   # stays on your machine

3. Sign a request

headers = agent.sign_headers(method="POST", url="https://partner.example/api", body=payload)
# X-AgentID, X-AgentID-Timestamp, X-AgentID-Signature

4. Verify another agent

info = reg.verify("AID-DE-BE-BER-2026-004211-Q2")
assert info.status == "active"
reg.verify_signature(aid, headers, body)   # raises if invalid

5. Go to production

Create an account, pay for the plan (or let the agent pay via x402) and switch sandbox=False. Sandbox IDs cannot be promoted — production IDs are issued fresh with a real territory code.