Python SDK

pip install "openagentid-sdk @ git+https://github.com/OpenAgentID/openagent-sdk.git#subdirectory=sdks/python"
pip install blake3   # optional: canonical cross-SDK key derivation

from openagent_sdk import Verifier, Scope

verifier = Verifier(
    [broker_public_key],          # raw 32-byte Ed25519 keys
    "arsenal:broker:prod-1",      # expected issuer
    "my-service",                 # this service's audience
    required_scopes=[Scope.parse("tools:calendar:invoke")],
)
claims = verifier.verify(token_bytes)

from fastapi import FastAPI
from openagent_sdk.middleware import require_act

app = FastAPI()

@app.post("/tools/calendar",
          dependencies=[require_act(verifier, scopes=["tools:calendar:invoke"])])
async def handle():
    return {"ok": True}

from openagent_sdk import Agent

agent = await Agent.create("my-agent")
session = await agent.authenticate("https://api.example.com")
grant = await session.grant("tools:calendar:invoke", ttl_seconds=300)

from openagent_sdk import keys

agent = keys.generate()
keys.save_seed(agent, "agent.seed")           # owner-only (0600)
restored = keys.from_seed_file("agent.seed")
# or: keys.from_env("AGENT_SEED_HEX")