eil-card 0.2.0

EIL Card Python SDK — resolve verified entity identity for AI agents

EIL Card Python SDK (eil-card)

Resolve verified organization and person identity from the EIL Card registry — with LangChain, CrewAI, and LlamaIndex integrations.

Install

pip install eil-card

Optional framework extras:

pip install eil-card[langchain]
pip install eil-card[llamaindex]
pip install eil-card[crewai]
pip install eil-card[all]

Quick start

from eil_card import DigitalCard, discover_capabilities, discover_act_capabilities

result = DigitalCard.resolve(domain="sinyalle.com")
card = result["card"]
print(card["name"]["official"], card.get("verified"))

caps = discover_capabilities(card)
if caps["available"]:
    print("Gateway:", caps["agent_gateway"])

act = discover_act_capabilities(card)
print("Write/act scopes:", act["scopes_parsed"]["write"], act["scopes_parsed"]["act"])

LangChain

from eil_card.integrations.langchain import create_eil_resolve_tool

tool = create_eil_resolve_tool()
# tools = [tool]

Tool name matches the TypeScript SDK: resolve_entity_identity.

CrewAI

from crewai import Agent
from eil_card.integrations.crewai import create_eil_resolve_crewai_tool

resolve_tool = create_eil_resolve_crewai_tool()
agent = Agent(role="Researcher", goal="Verify entities", tools=[resolve_tool])

LlamaIndex

from eil_card.integrations.llamaindex import EILReader

docs = EILReader().load_data(domain="sinyalle.com")

JWS trust (Registry+)

from eil_card import DigitalCard

result = DigitalCard.resolve(domain="sinyalle.com", verify_jws=True)
print(result.get("trust", {}).get("jws"))

# Crypto verify: pip install eil-card[crypto]
result = DigitalCard.resolve(
    domain="sinyalle.com",
    verify_jws={"public_key_pem": open("registry-public.pem").read(), "require_valid": True},
)

Access policy ("robots.txt for agents")

from eil_card import DigitalCard, discover_access_policy, is_training_denied

result = DigitalCard.resolve(domain="sinyalle.com")
policy = discover_access_policy(result["card"])
# {"read": "gateway", "act": "gateway", "training": "deny", "state": "active", ...}

if is_training_denied(result["card"]):
    skip_for_training()

if policy["read"] == "deny":
    raise SystemExit("Entity opts out of agent access")

See EIL Access Policy Spec.

Agent act headers (pilot gateway)

from eil_card import build_idempotency_key, build_agent_act_headers, agent_act_headers_to_fetch

key = build_idempotency_key(
    agent_client_id="my-agent",
    action_id="create_post",
    entity_id="sinyalle.com",
    nonce="run-1",
)
headers = agent_act_headers_to_fetch(
    build_agent_act_headers(
        access_token="...",
        idempotency_key=key,
        action_id="create_post",
        card_id="sinyalle.com",
    )
)

Development

cd packages/python
pip install -e ".[dev]"
pytest

Publish (maintainers)

pip install build twine
python -m build
twine upload dist/*

Set PYPI_API_TOKEN in the environment or ~/.pypirc.

Docs

• https://eilcard.com/docs/agents
• TypeScript SDK parity: packages/sdk/SDK.md