agent-id (Python)

Idiomatic Python port of @p-vbordei/agent-id. Self-custody DID + capability Verifiable Credential profile for AI agents. Byte-deterministic-compatible with the TypeScript reference: passes the same C1 / C2 / C3 conformance vectors. 17 tests pass.

What's in the box

• generate_key_pair() / did_key_from_public_key() — Ed25519 keys + did:key codec.
• issue(opts) — sign a Capability VC with the eddsa-jcs-2022 cryptosuite.
• verify(vc) — JSON-Schema → validity window → signature → DID resolution, accumulating errors.
• resolve(did) — did:key (offline) and did:web (HTTP, with timeout + response cap) resolution.

Install

pip install agent-id
# or
uv add agent-id

Quickstart

import asyncio
from agent_id import IssueOptions, did_key_from_public_key, generate_key_pair, issue, verify

async def main() -> None:
    principal = generate_key_pair()
    agent = generate_key_pair()

    vc = await issue(IssueOptions(
        principal=principal,
        subject={
            "id": did_key_from_public_key(agent.public_key),
            "type": "Agent",
            "principal": did_key_from_public_key(principal.public_key),
            "model": {"vendor": "anthropic", "id": "claude-opus-4-7"},
            "capability": {"action": "answer", "sla": {"latency_ms_p95": 2000}},
            "valid_from": "2026-04-24T00:00:00.000Z",
        },
    ))

    result = await verify(vc)
    print(f"issued VC for {vc['credentialSubject']['id']}")
    print(f"verified  = {result.verified}")

asyncio.run(main())

Run it:

python examples/quickstart.py

How it relates

All three implementations produce byte-identical output for serialization-critical surfaces. See docs/architecture.md for details.

Conformance

uv run pytest -v          # runs the same C1 / C2 / C3 vectors as the TS reference

Vectors in vectors/ are copied verbatim from the TS conformance suite. Pass / fail behaviour matches byte-for-byte.

Architecture

See docs/architecture.md for the module layout, dependency choices, and byte-determinism invariants.

Development

git clone https://github.com/p-vbordei/agent-id-py
cd agent-id-py
uv venv -p 3.13
uv pip install -e ".[dev]"
uv run pytest -v
uv run ruff check .

Contributions welcome — see CONTRIBUTING.md.

License

Apache-2.0 — see LICENSE.