agent-seal-xyz 0.1.0

Give your AI agent a signed, verifiable identity in one line.

agent-seal

Give your AI agent a signed, verifiable identity in one line.

agent-seal registers your AI agent with the Agent Seal Registry — a court-grade, cryptographic identity system for autonomous agents. Keys are generated locally and never leave your machine; the registry only ever sees public keys and signatures.

Quick start

from agent_seal import seal

agent = seal(
    name="my-agent",
    architect="[e-mail]",
    capabilities=["code-review"],
)
print(agent.sijil, agent.seal_url)

That's it. Your agent now has a public, cryptographically verifiable identity.

Install

pip install agent-seal

CLI

# Register
agent-seal register --name my-agent --architect [e-mail] --capabilities code-review,pr-analysis

# Check status
agent-seal status <agent-id>

# Verify seal and card
agent-seal verify <agent-id>

API

seal(name, architect, capabilities=None, *, model="unknown", private_key=None)

Registers an agent and returns an AgentRegistration object.

Attribute	Type	Description
agent.sijil	int	Sijil number in the registry
agent.seal_url	str	URL to the agent's SVG seal
agent.badge_url	str	URL to the embeddable badge
agent.verify_url	str	URL to verify the seal
agent.agent_id	str	UUID in the registry
agent.public_key	str	Hex-encoded Ed25519 public key
agent.manifest_hash	str	SHA-256 hash of the covenant

AgentSealClient(registry_url="https://agent-seal.xyz")

Lower-level client with register(), status(), and verify() methods.

Key management

On first use, agent-seal generates an Ed25519 keypair and stores it at:

~/.agent-seal/keys/private.hex   (mode 0600)
~/.agent-seal/keys/public.hex    (mode 0600)

The private key never leaves your machine. To re-use an existing identity across environments (e.g., CI), pass private_key= as a hex string.

Error handling

from agent_seal import seal, AgentSealError, RateLimitError

try:
    agent = seal(name="my-agent", architect="[e-mail]")
except RateLimitError as e:
    print(f"Rate limited. Retry in {e.retry_after}s.")
except AgentSealError as e:
    print(f"Registration failed: {e}")

Rate-limited requests (HTTP 429) are retried automatically up to 3 times, respecting the Retry-After header.

What is Agent Seal?

Agent Seal is a public registry that gives AI agents cryptographic, human-accountable identities. Every registered agent receives a Sijil number, a signed covenant, and a public seal — verifiable by anyone at agent-seal.xyz/verifier.

Built for the EU AI Act era: immutable audit trail, liability anchors, and EU AI Act readiness evidence out of the box.

---

agent-seal.xyz · Verify an agent · Registry API