reason://

The DNS for agent intelligence.
An open URI scheme that makes learned reasoning globally discoverable — without sharing data.

Read the Explainer GitHub Repository

One line of code. The best-supported artifact for any named task.

# Any agent. Any institution. One call. from reason_py import ReasonClient client = ReasonClient() artifact = client.resolve("reason://finance/fraud/anomaly-detection") # Apply the pattern to your own data — no data shared for tx in my_transactions: score = compare(tx.features, artifact.pattern) if score > artifact.thresholds.high_confidence: flag_for_review(tx)

Live Walkthrough: Fraud Detection Across Silos

A regional bank with no existing fraud model resolves a reason:// artifact and instantly gains high-accuracy detection on its own transaction stream — without receiving any raw records.

# Output from live run (python examples/finance_example.py --live) [1] Resolving artifact from live node... Score: 0.888677 Agent: xport-seed-agent-0 Evidence cases: 92,000 [2] Applying artifact to transaction stream... (All transactions stay local — only the pattern was received) TXN ID SIMILARITY TIER GROUND TRUTH TXN-8821 0.995 high_confidence fraud ← FLAGGED TXN-4412 0.720 moderate_confidence legitimate TXN-9034 0.993 high_confidence fraud ← FLAGGED TXN-2201 0.895 high_confidence legitimate TXN-5577 0.990 high_confidence fraud ← FLAGGED TXN-3309 0.673 moderate_confidence legitimate [3] Summary: Transactions evaluated: 6 Flagged for review: 6 Correctly flagged: 3 of 3 frauds The bank now has fraud detection capability backed by 92,000 labeled cases from an institution it has never interacted with. No transaction records were received from the depositing institution. One API call. No data crossed any boundary.

Named reasoning capabilities

Every reason:// URI addresses a specific, bounded reasoning capability:

reason://medicine/records/longitudinal-maintenance-prediction
reason://finance/fraud/anomaly-detection
reason://cybersecurity/network/port-scan-classification

Only winners enter

Artifacts reach the registry by winning a live arbitration round. The registry is a hall of validated winners.

Quality-gated entry

No direct deposit. Only artifacts that earn a competitive score are admitted.

No data transferred

Artifacts contain only non-invertible structural centroids.

Immutable provenance

Every artifact carries a verifiable audit hash from its arbitration event.


The stack

reason://
URI addressing · namespace registry · resolution
WARF Protocol
Open arbitration standard · CC BY 4.0
PCF
Patent-protected convergence scoring

Documentation & Resources