Context Passport — Python Reference Implementation

A reference implementation of the Context Passport v2.0 specification in Python.

v2.0: Adopts RFC 8785 (JSON Canonicalization Scheme) for cross-implementation byte-equivalence. v1.x records remain verifiable via context_passport.compat.v1. See the migration guide.

Specification: https://github.com/contextpassport/spec License: Apache-2.0

Install

pip install context-passport

Optional extras:

pip install "context-passport[signing]"        # Ed25519 signing support
pip install "context-passport[langgraph]"      # LangChain/LangGraph callback handler

Usage

from context_passport import make_passport, verify_chain

# Root commit
root = make_passport(
    agent_id="agent-researcher-01",
    agent_name="Research Agent",
    payload={"input": "Analyze Q1 earnings", "output": {"summary": "APAC up 34%"}},
    role="researcher",
    provider="anthropic",
    model="claude-opus-4-6",
)

# Child commit
child = make_passport(
    agent_id="agent-writer-01",
    agent_name="Writer Agent",
    payload={"input": root["payload"]["output"], "output": "Draft prepared."},
    parent=root,
)

# Verify the chain
assert verify_chain([root, child])

Conformance

This implementation targets Core conformance with the Context Passport v1.0 conformance test suite. Signed conformance is planned.

To run the conformance tests against this implementation:

git clone https://github.com/contextpassport/conformance-tests.git
cd conformance-tests
python runner/python/run.py --implementation context_passport

Contributing

See CONTRIBUTING.md in the spec repository. Bug reports and pull requests welcome on this repo.

Related repositories

• contextpassport/spec — the specification
• contextpassport/typescript — TypeScript reference implementation
• contextpassport/conformance-tests — conformance test suite